Diagnostics

Axint diagnostics follow a three-letter prefix (AX) and a three-digit code. The first digit usually identifies the stage:

• AX0xx — parser (TypeScript AST)
• AX1xx — IR validator
• AX2xx — Swift validator
• AX7xx — Swift source / Apple runtime validator
• AXPxxx — Python parser (axint SDK)

Parser diagnostics (AX0xx)

Code	Severity	What it means
AX001	error	TypeScript source failed to parse
AX002	error	Couldn’t find a top-level defineIntent() call
AX003	error	defineIntent() argument is not an object literal
AX004	error	Required field missing from defineIntent()
AX005	error	Field value is not a string / boolean / array literal
AX006	error	params must be an object literal
AX007	error	Parameter value must be a param.*() call
AX008	error	Missing description argument to param.*()

IR validator diagnostics (AX1xx)

Code	Severity	What it means
AX100	error	name must be a valid Swift identifier ending in “Intent”
AX101	error	domain is not a recognized App Intent domain
AX102	warning	description is over 200 characters
AX103	warning	Parameter name isn’t a valid Swift identifier
AX104	error	Unknown parameter type
AX105	error	default is required when optional: false and no fallback is provided
AX106	warning	Parameter count is over Apple’s recommended 8
AX107	error	Duplicate parameter name
AX108	warning	Malformed entitlement identifier (expected reverse-DNS)
AX109	warning	Non-standard Info.plist key prefix

Swift validator diagnostics (AX2xx)

Code	Severity	What it means
AX200	error	Generated Swift failed a structural sanity check
AX201	warning	Generated Swift contains an unescaped string that could inject code
AX202	error	Generated Swift line length exceeds 500 chars (likely a bug)

Swift source and Apple runtime diagnostics (AX7xx)

Code	Severity	What it means
AX736	warning	Container accessibilityIdentifier can hide child identifiers in SwiftUI UI tests
AX764	warning	Overlay on a SwiftUI text input may block hit testing
AX765	error	Invalid SwiftUI frame(maxWidth:height:) overload
AX766	warning	Project-specific SwiftUI modifier appears after a type-erasing modifier

Python parser diagnostics (AXPxxx)

Code	Severity	What it means
AXP001	error	Python source failed to parse
AXP002	error	Required define_intent() argument missing
AXP003	error	params is not a dict literal
AXP004	error	params key is not a string literal
AXP005	error	params value is not a param.*() call
AXP006	error	Unknown param.* type
AXP007	error	param.* description must be a string literal
AXP008	error	entitlements must be a list of string literals and info_plist_keys must be a list of strings or a dict of string pairs
AXP009	error	Required string field is not a string literal

Suppressing warnings

You can suppress a specific warning code with a comment:

// axint-disable-next-line AX106
params: {
  a: param.string("..."), b: param.string("..."), c: param.string("..."),
  d: param.string("..."), e: param.string("..."), f: param.string("..."),
  g: param.string("..."), h: param.string("..."), i: param.string("..."),
}

Errors can’t be suppressed — fix them.