peekie-warnings

peekie warnings

List every build warning in a .xcresult bundle as a flat sorted JSON array (or human-readable list).

Synopsis

peekie warnings <xcresult-path> [flags]

Flags

Flag	Default	Notes
<xcresult-path>	—	Required positional. Path to the .xcresult bundle.
--format json|list	json	Output format.
-v, --verbose	false	Debug-level logging to stderr.

There is no --include flag on peekie warnings. Filter with jq.

Output shape

--format json (default)

Flat sorted array, one entry per warning:

[
  {"file": "Foo.swift", "line": 42, "column": 8, "type": "DeprecatedDeclaration", "message": "'oldFoo()' is deprecated: use bar()"},
  {"file": "Bar.swift", "line": 12, "column": 4, "type": "ActorIsolatedCall", "message": "Main actor-isolated initializer cannot be called from outside the actor"},
  {"file": "Calculator.swift", "line": 7, "column": 17, "type": "Swift Compiler Error", "message": "Some warning from Calculator"}
]

• line / column are null when xcresult didn't emit them.
• type values are the raw Apple issueType strings: Swift Compiler Warning, Swift Compiler Error, DeprecatedDeclaration, No-usage, ActorIsolatedCall, plus whatever new categories Apple adds.

--format list

One line per warning, grouped by file.

The #warning(...) quirk — important

Xcode mis-tags #warning("text") directives as type: "Swift Compiler Error" even though they're warnings and appear in peekie warnings output (not peekie errors).

The message for a #warning("Some text") directive is just the bare string passed to the directive — "Some text" — with no #warning wrapper, no quote marks, no syntactic giveaway. Don't try to detect them by grepping the message for #warning; the substring isn't there.

Default assumption: every entry with type == "Swift Compiler Error" in peekie warnings output is a #warning(...) developer marker, not a real defect. Real compiler errors land in peekie errors, not here. Treat the count of Swift Compiler Error entries as "TODO markers left in the source"; treat the other types as defects worth prioritizing.