feat: wildcard spec

[anton62k]

Summary by cubic

Adds wildcard array property access ([*]) and expands the formula spec with new path and context features. Updates the spec generator to auto-render features with consistent formatting and dependency notes.

• New Features

  • Array [] wildcard property access with mapping/flattening; supports nested arrays (e.g., sum(orders[].items[*].amount)).
  • sum/avg docs note wildcard support.
  • Root (/...) and relative (../...) paths with dependency extraction.
  • Bracket notation for hyphenated keys.
  • Array context tokens (#index, #length, #first/#last, @prev/@next, parent/root).
  • Fields can share names with built-ins (max, min, sum, round) without conflicts.

• Refactors

  • Auto-generate feature sections (v1.0–v1.2) via formatFeature().
  • Strip newlines in function descriptions in the table.
  • Add “Dependencies extracted” lines and clean up section names/examples.

^{Written for commit e3479ff. Summary will update on new commits. Review in cubic}

[cubic-dev-ai]

2 issues found across 2 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="scripts/generate-spec-md.ts">

<violation number="1" location="scripts/generate-spec-md.ts:15">
P2: Silently returning an empty string for unknown features will hide missing/typoed feature names and generate incomplete SPEC.md without any error. Failing fast (or logging) makes regressions detectable.</violation>
</file>

<file name="SPEC.md">

<violation number="1" location="SPEC.md:232">
P2: Document the minVersion for `array_wildcard_property` in the Version Detection table; it’s now a supported v1.1 feature but is omitted from the table, so readers won’t see how the parser reports it.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud