Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.
Limited Release. The EDK is currently in limited release and is not available to all customers. Commands, generated file layouts, and package APIs may change before general availability. Confirm you’re on the latest EDK version before starting new projects.
Troubleshoot from the workspace outward. Confirm the target first, then isolate authoring and deployment failures before investigating records, automations, or agents. This order reduces unnecessary live changes and keeps each conclusion tied to evidence.The examples assume the organization workspace selects one matching saved profile. See Authentication if the target is ambiguous.Use the /elementum-debug coding-agent playbook when you want an assistant to follow this evidence-first sequence. See Playbooks.Before running commands, capture:
The exact action that failed.
The expected and actual results.
The profile and App namespace.
When the behavior last worked.
Any record, automation execution, or conversation identifier.
Do not edit source until the evidence identifies the failing layer.
1. Confirm the Profile and Workspace
Run from the affected organization workspace:
elementum auth statuselementum playbooks status
Confirm that the profile’s instance and organization match the workspace path. If the workspace is new or its generated references may be stale, verify that it was bootstrapped with:
elementum pull org --data-only
Classify an early failure as one of:
Authentication or permissions.
Profile and workspace mismatch.
Missing workspace setup.
Stale organization references.
Missing or incomplete App or Element source.
Pull the affected App or Element before editing an existing deployed object:
elementum pull app <namespace># orelementum pull element <namespace>
Review pull diagnostics and skipped items. Do not continue as though an unsupported part of the solution is managed by the generated source.List and pull commands paginate through large organizations. Pull writes are transactional, so a failed pull should not leave a partially replaced source tree. Correct the reported cause and rerun the pull rather than repairing generated output manually.
2. Isolate Typecheck and Build
Run the validation layers separately:
npx tsc --noEmitelementum build
If typecheck fails:
Fix the first causal error rather than every downstream error.
Confirm builder imports use public @elementumai/edk subpaths.
Confirm cross-entity references come from @catalog.
Refresh the organization or owning entity when an expected catalog token is missing. Run elementum generate when hand edits changed catalog-visible source.
Do not use a broad cast, guessed token, UUID, or generated-file edit to silence the error.
If build fails, use the source path and diagnostic in the output. A build diagnostic can mean that valid TypeScript contains an option the current deployment path cannot represent safely. Remove or change it only when that matches the intended behavior; otherwise report the limitation.Duplicate Agent tool, Skill tool, or A2A Skill names can collide when the complete workspace is assembled. The build error identifies the colliding names and source files; rename one of the authored tools or Skills rather than waiting for plan.Do not edit org.ts, generated/catalog.ts, .tf/in/, or .tf/out/ to repair a typecheck or build failure. Refresh or regenerate those paths with their owning commands.
3. Isolate Plan and Apply
After typecheck and build pass:
elementum plan
Separate:
Authentication or workspace selection failures.
Backend or deployment state failures.
Invalid authored configuration.
An unexplained create, replacement, or removal.
A difference that was authored correctly but has not been applied.
If the plan warns that an App or Element exists on disk but has not been adopted, or shows a known deployed object as new, stop. Re-run the appropriate pull without --no-adopt to restore the state binding. Do not apply a plan that would recreate known live objects.If a plan succeeds but live behavior is stale, confirm that the intended plan was applied and that any required automation revision or publication change was included. Never apply a speculative fix. Review the plan and obtain approval first.After an approved apply, run a fresh plan and confirm that no unintended changes remain.
4. Inspect Records and Automations
When deployment is current, inspect live data:
elementum records list <app-namespace> \ --limit 10 --jsonelementum interventions list <app-namespace> \ --status OPEN --json
Compare the stored record with the expected trigger inputs and final business result. Confirm field values, status or stage, relationships, files, and validation behavior.For an automation failure, begin with the execution timeline:
elementum automations status <app-namespace> \ "<automation-name>" --latest --timeline
Then inspect only the failed action:
elementum automations status <app-namespace> \ "<automation-name>" --latest-failure --io "<action-name>" --json
Compare the trigger data, action input, action output, persisted record state, and expected business outcome. Expand to the complete input and output report only when the failing boundary remains unclear:
elementum automations status <app-namespace> \ "<automation-name>" --latest --all-io --json
This sequence distinguishes a trigger problem from an action problem, a persistence problem, or a downstream integration problem.
Interpretation of the result in the final response.
Multi-turn context.
If a file is involved, reproduce with the same file type and a representative size by adding -a <path>. Verify the tool call and its effect independently; a reasonable final response does not prove that the correct tool ran.When an agent delegates work, inspect the delegated result separately from the parent agent’s use of that result.
Verify the Fix
State one evidence-backed root cause and the smallest layer that owns it. After changing source, rerun:
npx tsc --noEmitelementum plan
plan builds the current source automatically. After an approved apply, repeat the original record, automation, or conversation reproduction. Add one adjacent regression check that could have been affected by the fix.Report:
Root cause and owning layer.
Evidence used to reach the conclusion.
The change made.
Validation and live verification results.
Any remaining uncertainty or untested boundary.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Elementum Documentation","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/light.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=6f2a0a929de00ded269314ca98595339","dark":"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/dark.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=d6be9d3c273193977ee10bd4e34e7c69"},"favicon":"https://mintcdn.com/elementum/HFcyqoOHMh59mvyA/favicon.ico?fit=max\u0026auto=format\u0026n=HFcyqoOHMh59mvyA\u0026q=85\u0026s=e813105031a6caa3ee74fd5f49883eb4","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[],"primary":{"type":"button","label":"Open Elementum","href":"https://elementum.io"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/elementum-ai"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"elementum","hasAudioNarration":false,"actualSubdomain":"elementum","customDomains":["docs.elementum.io"],"gitSource":{"type":"github","owner":"elementumltd","repo":"documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcb8d0eb98bc45a9fcdf42","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Administration","count":31},{"language":"default","tag":"Workflows","count":31},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"AI \u0026 Agents","count":28},{"language":"default","tag":"Overview","count":21},{"language":"default","tag":"EDK","count":13},{"language":"default","tag":"Record Management","count":12},{"language":"default","tag":"Platform Administration","count":11},{"language":"default","tag":"Support","count":11},{"language":"default","tag":"Connections","count":10}]},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@elementum.elementum.io","showHelpButton":false}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#topbar-cta-button span{border-radius:.5rem}button{border-radius:.5rem!important}a.card{border-color:rgba(59, 130, 246, 0.4)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease}a.card:hover{border-color:#3B82F6!important;box-shadow:0 2px 8px rgba(59, 130, 246, 0.2)}.dark a.card{border-color:rgba(96, 165, 250, 0.4)!important}.dark a.card:hover{border-color:#60A5FA!important;box-shadow:0 2px 8px rgba(96, 165, 250, 0.2)}.inline-ui-icon{display:inline!important;width:1em;height:1em;vertical-align:middle;margin:0}.dark .inline-ui-icon[src$=\".png\"]{background-color:#e5e7eb;border-radius:3px;box-shadow:0 0 0 2px #e5e7eb}p .inline-ui-icon,li .inline-ui-icon,td .inline-ui-icon{display:inline!important}p span:has(>svg),li span:has(>svg),td span:has(>svg){display:inline!important;vertical-align:middle}p span:has(>svg) svg,li span:has(>svg) svg,td span:has(>svg) svg{display:inline-block!important;vertical-align:middle;width:1em;height:1em}.update:has(h3)>div:first-child{display:none!important}.update:has(h3)>div:last-child{width:100%!important;max-width:100%!important}@media (min-width: 1024px){.update:not(:has(h3))>div:first-child{flex:0 0 260px!important;width:260px!important;max-width:260px!important}}.deprecation-schedule table,.deprecation-schedule th,.deprecation-schedule td{font-size:1rem!important}.deprecation-schedule th,.deprecation-schedule td{padding-top:0.65rem!important;padding-bottom:0.65rem!important}.deprecation-schedule td code,.deprecation-schedule th code{font-size:0.9375rem!important}.email-form input{color:rgb(24 24 27);caret-color:rgb(24 24 27)}.email-form input:-webkit-autofill,.email-form input:-webkit-autofill:hover,.email-form input:-webkit-autofill:focus,.email-form input:-webkit-autofill:active{-webkit-text-fill-color:rgb(24 24 27)!important;-webkit-box-shadow:0 0 0 1000px #ffffff inset!important;caret-color:rgb(24 24 27)!important;transition:background-color 5000s ease-in-out 0s}.dark .email-form input{color:rgb(244 244 245);caret-color:rgb(244 244 245)}.dark .email-form input:-webkit-autofill,.dark .email-form input:-webkit-autofill:hover,.dark .email-form input:-webkit-autofill:focus,.dark .email-form input:-webkit-autofill:active{-webkit-text-fill-color:rgb(244 244 245)!important;-webkit-box-shadow:0 0 0 1000px rgb(24 24 27) inset!important;caret-color:rgb(244 244 245)!important;transition:background-color 5000s ease-in-out 0s}"}],"page":{"pagePath":"edk/guides/troubleshooting","slug":"/edk/guides/troubleshooting","pageMetadata":{"title":"Troubleshooting","description":"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.","href":"/edk/guides/troubleshooting"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Limited Release.`}),` The EDK is currently in limited release and is not available to all customers. Commands, generated file layouts, and package APIs may change before general availability. Confirm you’re on the latest EDK version before starting new projects.`]})}),`\n`,_jsx(_components.p,{children:`Troubleshoot from the workspace outward. Confirm the target first, then isolate authoring and deployment failures before investigating records, automations, or agents. This order reduces unnecessary live changes and keeps each conclusion tied to evidence.`}),`\n`,_jsxs(_components.p,{children:[`The examples assume the organization workspace selects one matching saved profile. See `,_jsx(_components.a,{href:`/edk/authentication`,children:`Authentication`}),` if the target is ambiguous.`]}),`\n`,_jsxs(_components.p,{children:[`Use the `,_jsx(_components.code,{children:`/elementum-debug`}),` coding-agent playbook when you want an assistant to follow this evidence-first sequence. See `,_jsx(_components.a,{href:`/edk/playbooks`,children:`Playbooks`}),`.`]}),`\n`,_jsx(_components.p,{children:`Before running commands, capture:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The exact action that failed.`}),`\n`,_jsx(_components.li,{children:`The expected and actual results.`}),`\n`,_jsx(_components.li,{children:`The profile and App namespace.`}),`\n`,_jsx(_components.li,{children:`When the behavior last worked.`}),`\n`,_jsx(_components.li,{children:`Any record, automation execution, or conversation identifier.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Do not edit source until the evidence identifies the failing layer.`}),`\n`,_jsx(Heading,{level:`2`,id:`1-confirm-the-profile-and-workspace`,children:`1. Confirm the Profile and Workspace`}),`\n`,_jsx(_components.p,{children:`Run from the affected organization workspace:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` auth`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` playbooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Confirm that the profile’s instance and organization match the workspace path. If the workspace is new or its generated references may be stale, verify that it was bootstrapped with:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` org`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-only`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Classify an early failure as one of:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Authentication or permissions.`}),`\n`,_jsx(_components.li,{children:`Profile and workspace mismatch.`}),`\n`,_jsx(_components.li,{children:`Missing workspace setup.`}),`\n`,_jsx(_components.li,{children:`Stale organization references.`}),`\n`,_jsx(_components.li,{children:`Missing or incomplete App or Element source.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Pull the affected App or Element before editing an existing deployed object:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` app`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# or`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` element`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Review pull diagnostics and skipped items. Do not continue as though an unsupported part of the solution is managed by the generated source.`}),`\n`,_jsx(_components.p,{children:`List and pull commands paginate through large organizations. Pull writes are transactional, so a failed pull should not leave a partially replaced source tree. Correct the reported cause and rerun the pull rather than repairing generated output manually.`}),`\n`,_jsx(Heading,{level:`2`,id:`2-isolate-typecheck-and-build`,children:`2. Isolate Typecheck and Build`}),`\n`,_jsx(_components.p,{children:`Run the validation layers separately:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tsc`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --noEmit`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` build`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`If typecheck fails:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Fix the first causal error rather than every downstream error.`}),`\n`,_jsxs(_components.li,{children:[`Confirm builder imports use public `,_jsx(_components.code,{children:`@elementumai/edk`}),` subpaths.`]}),`\n`,_jsxs(_components.li,{children:[`Confirm cross-entity references come from `,_jsx(_components.code,{children:`@catalog`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Refresh the organization or owning entity when an expected catalog token is missing. Run `,_jsx(_components.code,{children:`elementum generate`}),` when hand edits changed catalog-visible source.`]}),`\n`,_jsx(_components.li,{children:`Do not use a broad cast, guessed token, UUID, or generated-file edit to silence the error.`}),`\n`]}),`\n`,_jsx(_components.p,{children:`If build fails, use the source path and diagnostic in the output. A build diagnostic can mean that valid TypeScript contains an option the current deployment path cannot represent safely. Remove or change it only when that matches the intended behavior; otherwise report the limitation.`}),`\n`,_jsx(_components.p,{children:`Duplicate Agent tool, Skill tool, or A2A Skill names can collide when the complete workspace is assembled. The build error identifies the colliding names and source files; rename one of the authored tools or Skills rather than waiting for plan.`}),`\n`,_jsxs(_components.p,{children:[`Do not edit `,_jsx(_components.code,{children:`org.ts`}),`, `,_jsx(_components.code,{children:`generated/catalog.ts`}),`, `,_jsx(_components.code,{children:`.tf/in/`}),`, or `,_jsx(_components.code,{children:`.tf/out/`}),` to repair a typecheck or build failure. Refresh or regenerate those paths with their owning commands.`]}),`\n`,_jsx(Heading,{level:`2`,id:`3-isolate-plan-and-apply`,children:`3. Isolate Plan and Apply`}),`\n`,_jsx(_components.p,{children:`After typecheck and build pass:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Separate:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Authentication or workspace selection failures.`}),`\n`,_jsx(_components.li,{children:`Backend or deployment state failures.`}),`\n`,_jsx(_components.li,{children:`Invalid authored configuration.`}),`\n`,_jsx(_components.li,{children:`An unexplained create, replacement, or removal.`}),`\n`,_jsx(_components.li,{children:`A difference that was authored correctly but has not been applied.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If the plan warns that an App or Element exists on disk but has not been adopted, or shows a known deployed object as new, stop. Re-run the appropriate pull without `,_jsx(_components.code,{children:`--no-adopt`}),` to restore the state binding. Do not apply a plan that would recreate known live objects.`]}),`\n`,_jsx(_components.p,{children:`If a plan succeeds but live behavior is stale, confirm that the intended plan was applied and that any required automation revision or publication change was included. Never apply a speculative fix. Review the plan and obtain approval first.`}),`\n`,_jsx(_components.p,{children:`After an approved apply, run a fresh plan and confirm that no unintended changes remain.`}),`\n`,_jsx(Heading,{level:`2`,id:`4-inspect-records-and-automations`,children:`4. Inspect Records and Automations`}),`\n`,_jsx(_components.p,{children:`When deployment is current, inspect live data:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` records`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`app-namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --limit`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 10`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` interventions`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`app-namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` OPEN`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Compare the stored record with the expected trigger inputs and final business result. Confirm field values, status or stage, relationships, files, and validation behavior.`}),`\n`,_jsx(_components.p,{children:`For an automation failure, begin with the execution timeline:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` automations`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`app-namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cautomation-name>\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --latest`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --timeline`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Then inspect only the failed action:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` automations`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`app-namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cautomation-name>\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --latest-failure`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --io`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003caction-name>\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Compare the trigger data, action input, action output, persisted record state, and expected business outcome. Expand to the complete input and output report only when the failing boundary remains unclear:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` automations`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`app-namespac`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`e`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cautomation-name>\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --latest`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-io`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This sequence distinguishes a trigger problem from an action problem, a persistence problem, or a downstream integration problem.`}),`\n`,_jsx(Heading,{level:`2`,id:`5-inspect-agents-and-tools`,children:`5. Inspect Agents and Tools`}),`\n`,_jsx(_components.p,{children:`Reproduce an agent failure with one minimal turn:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` chat`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cagent-name>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -m`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cminimal reproduction>\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` conversation`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cagent-name>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`conversation-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Determine which layer failed:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Routing to the intended agent or capability.`}),`\n`,_jsx(_components.li,{children:`Agent instructions or confirmation boundaries.`}),`\n`,_jsx(_components.li,{children:`Tool selection.`}),`\n`,_jsx(_components.li,{children:`Tool inputs.`}),`\n`,_jsx(_components.li,{children:`The automation or service behind the tool.`}),`\n`,_jsx(_components.li,{children:`Returned data.`}),`\n`,_jsx(_components.li,{children:`Interpretation of the result in the final response.`}),`\n`,_jsx(_components.li,{children:`Multi-turn context.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`If a file is involved, reproduce with the same file type and a representative size by adding `,_jsx(_components.code,{children:`-a \u003cpath>`}),`. Verify the tool call and its effect independently; a reasonable final response does not prove that the correct tool ran.`]}),`\n`,_jsx(_components.p,{children:`When an agent delegates work, inspect the delegated result separately from the parent agent’s use of that result.`}),`\n`,_jsx(Heading,{level:`2`,id:`verify-the-fix`,children:`Verify the Fix`}),`\n`,_jsx(_components.p,{children:`State one evidence-backed root cause and the smallest layer that owns it. After changing source, rerun:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` tsc`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --noEmit`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`elementum`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`plan`}),` builds the current source automatically. After an approved apply, repeat the original record, automation, or conversation reproduction. Add one adjacent regression check that could have been affected by the fix.`]}),`\n`,_jsx(_components.p,{children:`Report:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Root cause and owning layer.`}),`\n`,_jsx(_components.li,{children:`Evidence used to reach the conclusion.`}),`\n`,_jsx(_components.li,{children:`The change made.`}),`\n`,_jsx(_components.li,{children:`Validation and live verification results.`}),`\n`,_jsx(_components.li,{children:`Any remaining uncertainty or untested boundary.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Troubleshooting","description":"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.","href":"/edk/guides/troubleshooting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Confirm the Profile and Workspace","slug":"1-confirm-the-profile-and-workspace","depth":2,"children":[]},{"title":"2. Isolate Typecheck and Build","slug":"2-isolate-typecheck-and-build","depth":2,"children":[]},{"title":"3. Isolate Plan and Apply","slug":"3-isolate-plan-and-apply","depth":2,"children":[]},{"title":"4. Inspect Records and Automations","slug":"4-inspect-records-and-automations","depth":2,"children":[]},{"title":"5. Inspect Agents and Tools","slug":"5-inspect-agents-and-tools","depth":2,"children":[]},{"title":"Verify the Fix","slug":"verify-the-fix","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"elementum","siteName":"Elementum Documentation","title":"Troubleshooting - Elementum Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-21T20:58:01.173Z","originalFileLocation":"edk/guides/troubleshooting.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Elementum Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Troubleshooting - Elementum Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Elementum Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.elementum.io/edk/guides/troubleshooting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://elementum.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Troubleshooting\u0026amp;description=Diagnose+workspace%2C+build%2C+deployment%2C+automation%2C+record%2C+and+agent+failures+in+a+reliable+order.\u0026amp;theme=f2077c0582052f05ca4a5fc0\u0026amp;signature=91ad71f33ce8af22fbcfb51426e6937031b4e2e93f8f2847afd88063f28524d8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Troubleshooting - Elementum Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://elementum.mintlify.site/_mintlify/api/og/v2?division=Guides\u0026amp;title=Troubleshooting\u0026amp;description=Diagnose+workspace%2C+build%2C+deployment%2C+automation%2C+record%2C+and+agent+failures+in+a+reliable+order.\u0026amp;theme=f2077c0582052f05ca4a5fc0\u0026amp;signature=91ad71f33ce8af22fbcfb51426e6937031b4e2e93f8f2847afd88063f28524d8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/elementum/61PalhAEBeln8LgR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Elementum Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.elementum.io/edk/guides/troubleshooting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/edk/guides/troubleshooting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.elementum.io/#organization\",\"name\":\"Elementum Documentation\",\"url\":\"https://docs.elementum.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/elementum/zEtDA8cEluOX9_Yd/logo/light.svg?fit=max\u0026auto=format\u0026n=zEtDA8cEluOX9_Yd\u0026q=85\u0026s=6f2a0a929de00ded269314ca98595339\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.elementum.io#website\",\"name\":\"Elementum Documentation\",\"url\":\"https://docs.elementum.io\",\"publisher\":{\"@id\":\"https://docs.elementum.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.elementum.io/edk/guides/troubleshooting#webpage\",\"url\":\"https://docs.elementum.io/edk/guides/troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\",\"dateModified\":\"2026-08-21T20:58:01.173Z\",\"isPartOf\":{\"@id\":\"https://docs.elementum.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.elementum.io/edk/guides/troubleshooting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.elementum.io/edk/guides/troubleshooting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://docs.elementum.io/edk/installation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Troubleshooting\",\"item\":\"https://docs.elementum.io/edk/guides/troubleshooting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.elementum.io/edk/guides/troubleshooting#article\",\"headline\":\"Troubleshooting\",\"name\":\"Troubleshooting\",\"description\":\"Diagnose workspace, build, deployment, automation, record, and agent failures in a reliable order.\",\"url\":\"https://docs.elementum.io/edk/guides/troubleshooting\",\"mainEntityOfPage\":{\"@id\":\"https://docs.elementum.io/edk/guides/troubleshooting#webpage\"},\"dateModified\":\"2026-08-21T20:58:01.173Z\",\"publisher\":{\"@id\":\"https://docs.elementum.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.elementum.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Elementum Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Elementum Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/edk/guides/troubleshooting.md","siteName":"Elementum Documentation","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/getting-started/welcome-to-elementum"}]},{"tab":"Workflows","pages":[{"title":"Workflows","href":"/getting-started/build-an-app"}]},{"tab":"AI \u0026 Agents","pages":[{"title":"AI \u0026 Agents","href":"/ai-agents/ai-overview"}]},{"tab":"Data \u0026 Analytics","pages":[{"title":"Data \u0026 Analytics","href":"/data/data-best-practices"}]},{"tab":"Administration","pages":[{"title":"Administration","href":"/administration/access-overview"}]},{"tab":"EDK","groups":[{"group":"Get Started","pages":[{"title":"Overview","href":"/edk/getting-started"},{"title":"Quickstart","href":"/edk/quickstart"}]},{"group":"Guides","pages":[{"title":"Installation","href":"/edk/installation"},{"title":"Authentication","href":"/edk/authentication"},{"title":"Playbooks","href":"/edk/playbooks"},{"title":"Authoring","href":"/edk/authoring"},{"title":"Plan and Apply","href":"/edk/plan-and-apply"},{"title":"Acceptance Testing","description":"Test deployed records, files, automations, agents, and complete business journeys.","href":"/edk/guides/acceptance-testing"},{"title":"Troubleshooting","href":"/edk/guides/troubleshooting"}]},{"group":"Design","pages":[{"title":"Design with EDK","description":"Design Elementum processes and record experiences before implementing them.","href":"/edk/design/overview"},{"title":"Record Experiences","href":"/edk/guides/design"},{"title":"Design Validation","href":"/edk/design/validation"}]},{"group":"Reference","pages":[{"title":"CLI Reference","href":"/edk/cli-reference"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/api-introduction"}]}]},"basePath":"","title":"Troubleshooting - Elementum Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":[],"chunks":[]}