fix(lint): describe unquoted JSON references as failing only when the text is not itself JSON

[waleedlatif1]

Summary

• The v2 workflow lint contract described unquoted-json-string findings as references that "will not work as written", which overstates them: a text output inserted raw is still valid JSON when its runtime value is itself JSON (true, 42, an object).
• The description now says these leave the field invalid JSON at run time unless the text is itself JSON, matching the lint reason the deploy warning and the agent already see. unknown-field and missing-block findings keep the unconditional wording, since those always fail.
• Regenerated apps/docs/openapi-v2-workflows.json from the contract.

Type of Change

• Bug fix (docs/contract wording)

Testing

• generate:openapi, check:openapi, check:cli-docs (no CLI docs change), docs:check
• bun run lint, check:audits (58), type-check, docs-manifest:check
• Root bun run test: two timing-sensitive tests in unrelated files (html-parser.test.ts, remark-plain-text.test.ts) failed under full-suite load and pass in isolation

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing (new tests pass the test-audit authoring gate)
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
docs	Ready	Preview	Oct 9, 2026 5:10pm UTC

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

_{Turn on auto-fix | Re-trigger cubic}

[greptile-apps]

Confidence Score: 5/5

[Low impact] This wording-only change appears safe to merge.

Summary

Clarifies that unquoted text references can leave JSON fields invalid unless the inserted text is itself JSON.

• Updates the workflow contract description and its generated OpenAPI copy together.
• Leaves lint checks, response shapes, and runtime behavior unchanged.
• No actionable issues found.

_{Reviews (1) · Last reviewed commit: "fix(lint): describe unquoted JSON refere..." · Reviewed by Greptile}