Skip to content

feat(cli): Add type search - #7

Merged
philprime merged 3 commits into
mainfrom
philprime/feat/add-type-search
Sep 9, 2026
Merged

feat(cli): Add type search#7
philprime merged 3 commits into
mainfrom
philprime/feat/add-type-search

Conversation

@philprime

Copy link
Copy Markdown
Member

Add apple-docs types search on top of the type discovery work in #6. Search walks a technology’s root DocC page and recursively linked collection groups, returning matching symbol names and paths without crawling every symbol page.

Search Behavior

apple-docs types search Button --technology SwiftUI
apple-docs types search Button --technology SwiftUI --json
  • Match symbol names and DocC paths case-insensitively.
  • Deduplicate results and preserve deterministic ordering.
  • Resolve technology display names through the catalog.
  • Return actionable root-list and documentation links when no symbols match.

Traversal and Privacy

Collection pages are fetched in batches of six to bound concurrency and avoid an exhaustive symbol-page crawl. Search queries remain excluded from telemetry while result counts use an allowlisted metric.

Verification

  • make test.
  • make analyze with no violations.
  • make build.
  • TELEMETRY_DISABLED=true make test-integration with 7 live tests passing.

@philprime
philprime added this pull request to stack #8 September 9, 2026 14:40
Traverse technology collection groups with bounded concurrency and return matching symbol names and paths in table or JSON form. Keep queries out of telemetry and provide actionable guidance when no symbols match.
@philprime
philprime force-pushed the philprime/feat/add-type-discovery branch from 9ff76b9 to 07747e8 Compare September 9, 2026 14:42
@philprime
philprime force-pushed the philprime/feat/add-type-search branch from 4dd4b4e to d1bae6c Compare September 9, 2026 14:42
Base automatically changed from philprime/feat/add-type-discovery to main September 9, 2026 14:42
Comment thread Sources/CLI/client/AppleDocumentationClient+Search.swift Outdated
@philprime
philprime removed this pull request from stack #8 September 9, 2026 15:02
@philprime
philprime enabled auto-merge (squash) September 9, 2026 15:03
Comment thread Sources/CLI/client/AppleDocumentationClient+Search.swift Outdated
@philprime
philprime merged commit 0ee3f07 into main Sep 9, 2026
12 checks passed
@philprime
philprime deleted the philprime/feat/add-type-search branch September 9, 2026 15:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant