apple-docs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,114 @@
+# apple-docs-cli
+
+CLI for querying Apple Developer Documentation. Searches docs, browses frameworks, WWDC videos, sample code, and more.
+
+Built on top of [apple-docs-mcp](https://github.com/kimsungwhee/apple-docs-mcp) — uses its library directly, no MCP server needed.
+
+## Install
+
+```bash
+git clone https://github.com/mtcnbzks/apple-docs-cli.git
+cd apple-docs-cli
+npm install
+npm run build
+npm link
+```
+
+## Usage
+
+```
+apple-docs <command> [args] [--flags]
+```
+
+### Search & Documentation
+
+```bash
+# Search Apple docs
+apple-docs search "SwiftUI List"
+apple-docs search "CoreML" --type documentation
+
+# Get full doc page content
+apple-docs doc "https://developer.apple.com/documentation/swiftui/list"
+
+# Browse all Apple frameworks
+apple-docs tech
+apple-docs tech "App Frameworks" --limit 10
+
+# Browse symbols in a framework
+apple-docs symbols swiftui
+apple-docs symbols uikit --type class --limit 20
+apple-docs symbols foundation --type protocol --language swift
+```
+
+### WWDC
+
+```bash
+# List videos by year
+apple-docs wwdc 2025
+apple-docs wwdc 2024 --limit 10
+
+# Search transcripts and code
+apple-docs wwdc-search "async await"
+
+# Get full video content (transcript + code)
+apple-docs wwdc-video 2025 245
+
+# Browse code examples
+apple-docs wwdc-code SwiftUI --limit 5
+
+# Browse topics
+apple-docs wwdc-topics swift
+
+# List available years
+apple-docs wwdc-years
+```
+
+### Sample Code
+
+```bash
+apple-docs sample "camera"
+apple-docs sample --framework SwiftUI
+```
+
+### API Analysis
+
+```bash
+# Related APIs
+apple-docs related "https://developer.apple.com/documentation/swiftui/list"
+
+# Similar/alternative APIs
+apple-docs similar "https://developer.apple.com/documentation/swiftui/list"
+
+# Platform compatibility
+apple-docs platform "https://developer.apple.com/documentation/swiftui/list"
+
+# Resolve referenced types
+apple-docs references "https://developer.apple.com/documentation/swiftui/list"
+```
+
+### Updates & Overviews
+
+```bash
+apple-docs updates
+apple-docs updates --technology SwiftUI --year 2025
+apple-docs overviews --platform ios
+```
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `--type <type>` | Symbol/search type filter (class, struct, enum, protocol) |
+| `--limit <n>` | Max results |
+| `--year <year>` | Year filter |
+| `--framework <fw>` | Framework filter |
+| `--topic <topic>` | Topic filter |
+| `--platform <p>` | Platform filter (ios, macos, watchos, tvos, visionos) |
+| `--query <q>` | Search query filter |
+| `--technology <t>` | Technology filter |
+| `--language <lang>` | Language filter (swift, occ) |
+| `--depth <d>` | Search depth (shallow, medium, deep) |
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+import { callTool } from './mcp.js';
+const [, , command, ...rest] = process.argv;
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const key = arg.slice(2);
+            flags[key] = argv[++i] || '';
+        }
+        else if (arg.startsWith('-') && arg.length === 2) {
+            const key = arg.slice(1);
+            flags[key] = argv[++i] || '';
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, flags };
+}
+const { positional, flags } = parseArgs(rest);
+const num = (key) => flags[key] ? parseInt(flags[key], 10) : undefined;
+const HELP = `Usage: apple-docs <command> [args] [--flags]
+
+Commands:
+  search <query>              Search Apple documentation
+  doc <url>                   Get documentation content
+  tech [category]             List Apple technologies
+  symbols <framework>         Browse framework symbols
+  wwdc [year] [topic]         Browse WWDC videos
+  wwdc-search <query>         Search WWDC transcripts
+  wwdc-video <year> <id>      Get WWDC video content
+  wwdc-code [framework]       Get WWDC code examples
+  wwdc-topics [topicId]       Browse WWDC topics
+  wwdc-years                  List available WWDC years
+  sample [query]              Browse sample code
+  related <url>               Find related APIs
+  similar <url>               Find similar APIs
+  platform <url>              Check platform compatibility
+  updates [category]          Documentation updates
+  overviews [category]        Technology overviews
+  references <url>            Resolve API references
+
+Flags:
+  --type <type>         Symbol/search type filter
+  --limit <n>           Max results
+  --year <year>         Year filter
+  --framework <fw>      Framework filter
+  --topic <topic>       Topic filter
+  --platform <p>        Platform filter (ios, macos, watchos, tvos, visionos)
+  --query <q>           Search query filter
+  --technology <t>      Technology filter
+  --language <lang>     Language filter (swift, occ)
+  --depth <d>           Search depth (shallow, medium, deep)`;
+function need(val, usage) {
+    if (!val) {
+        console.error(usage);
+        process.exit(1);
+    }
+    return val;
+}
+async function main() {
+    switch (command) {
+        case 'search':
+            console.log(await callTool('search_apple_docs', {
+                query: need(positional.join(' ') || undefined, 'Usage: apple-docs search <query>'),
+                type: flags['type'] || 'all',
+            }));
+            break;
+        case 'doc':
+            console.log(await callTool('get_apple_doc_content', {
+                url: need(positional[0], 'Usage: apple-docs doc <url>'),
+                includeRelatedApis: flags['related'] === 'true',
+                includeReferences: flags['refs'] === 'true',
+                includeSimilarApis: flags['similar'] === 'true',
+                includePlatformAnalysis: flags['platforms'] === 'true',
+            }));
+            break;
+        case 'tech':
+            console.log(await callTool('list_technologies', {
+                category: positional[0],
+                language: flags['language'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'symbols':
+            console.log(await callTool('search_framework_symbols', {
+                framework: need(positional[0], 'Usage: apple-docs symbols <framework>'),
+                symbolType: flags['type'] || 'all',
+                namePattern: flags['pattern'],
+                language: flags['language'] || 'swift',
+                limit: num('limit'),
+            }));
+            break;
+        case 'wwdc':
+            console.log(await callTool('list_wwdc_videos', {
+                year: positional[0],
+                topic: positional[1] || flags['topic'],
+                hasCode: flags['code'] === 'true' ? true : undefined,
+                limit: num('limit'),
+            }));
+            break;
+        case 'wwdc-search':
+            console.log(await callTool('search_wwdc_content', {
+                query: need(positional.join(' ') || undefined, 'Usage: apple-docs wwdc-search <query>'),
+                searchIn: flags['in'] || 'both',
+                year: flags['year'],
+                language: flags['language'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'wwdc-video':
+            console.log(await callTool('get_wwdc_video', {
+                year: need(positional[0], 'Usage: apple-docs wwdc-video <year> <videoId>'),
+                videoId: need(positional[1], 'Usage: apple-docs wwdc-video <year> <videoId>'),
+                includeTranscript: flags['no-transcript'] !== 'true',
+                includeCode: flags['no-code'] !== 'true',
+            }));
+            break;
+        case 'wwdc-code':
+            console.log(await callTool('get_wwdc_code_examples', {
+                framework: positional[0] || flags['framework'],
+                topic: flags['topic'],
+                year: flags['year'],
+                language: flags['language'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'wwdc-topics':
+            console.log(await callTool('browse_wwdc_topics', {
+                topicId: positional[0],
+                includeVideos: flags['no-videos'] !== 'true',
+                year: flags['year'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'wwdc-years':
+            console.log(await callTool('list_wwdc_years', {}));
+            break;
+        case 'sample':
+            console.log(await callTool('get_sample_code', {
+                searchQuery: positional.join(' ') || undefined,
+                framework: flags['framework'],
+                beta: flags['beta'] || 'include',
+                limit: num('limit'),
+            }));
+            break;
+        case 'related':
+            console.log(await callTool('get_related_apis', {
+                apiUrl: need(positional[0], 'Usage: apple-docs related <url>'),
+            }));
+            break;
+        case 'similar':
+            console.log(await callTool('find_similar_apis', {
+                apiUrl: need(positional[0], 'Usage: apple-docs similar <url>'),
+                searchDepth: flags['depth'] || 'medium',
+                filterByCategory: flags['category'],
+            }));
+            break;
+        case 'platform':
+            console.log(await callTool('get_platform_compatibility', {
+                apiUrl: need(positional[0], 'Usage: apple-docs platform <url>'),
+                compareMode: flags['mode'] || 'single',
+                includeRelated: flags['related'] === 'true',
+            }));
+            break;
+        case 'updates':
+            console.log(await callTool('get_documentation_updates', {
+                category: positional[0] || 'all',
+                technology: flags['technology'],
+                year: flags['year'],
+                searchQuery: flags['query'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'overviews':
+            console.log(await callTool('get_technology_overviews', {
+                category: positional[0],
+                platform: flags['platform'] || 'all',
+                searchQuery: flags['query'],
+                limit: num('limit'),
+            }));
+            break;
+        case 'references':
+            console.log(await callTool('resolve_references_batch', {
+                sourceUrl: need(positional[0], 'Usage: apple-docs references <url>'),
+                maxReferences: num('limit'),
+                filterByType: flags['type'] || 'all',
+            }));
+            break;
+        default:
+            console.log(HELP);
+            if (command) {
+                console.error(`\nUnknown command: ${command}`);
+                process.exit(1);
+            }
+    }
+}
+main()
+    .then(() => process.exit(0))
+    .catch((err) => {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+});

package/dist/mcp.js

@@ -0,0 +1,17 @@
+import AppleDeveloperDocsMCPServer from '@kimsungwhee/apple-docs-mcp';
+import { handleToolCall } from '@kimsungwhee/apple-docs-mcp/dist/tools/handlers.js';
+const server = new AppleDeveloperDocsMCPServer();
+function extractText(result) {
+    const text = result.content
+        .filter((c) => c.type === 'text')
+        .map((c) => c.text)
+        .join('\n');
+    if (result.isError) {
+        throw new Error(text || 'Tool call failed');
+    }
+    return text;
+}
+export async function callTool(name, toolArgs = {}) {
+    const result = await handleToolCall(name, toolArgs, server);
+    return extractText(result);
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+	"name": "apple-docs",
+	"version": "1.0.0",
+	"description": "CLI for querying Apple Developer Documentation — search docs, browse frameworks, WWDC videos, sample code, and API analysis",
+	"license": "MIT",
+	"author": "mtcnbzks",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/mtcnbzks/apple-docs-cli.git"
+	},
+	"homepage": "https://github.com/mtcnbzks/apple-docs-cli",
+	"keywords": [
+		"apple",
+		"apple-developer",
+		"cli",
+		"swift",
+		"swiftui",
+		"ios",
+		"macos",
+		"wwdc",
+		"documentation",
+		"developer-tools"
+	],
+	"bin": {
+		"apple-docs": "dist/cli.js"
+	},
+	"type": "module",
+	"engines": {
+		"node": ">=18"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"prepublishOnly": "npm run build"
+	},
+	"files": [
+		"dist"
+	],
+	"dependencies": {
+		"@kimsungwhee/apple-docs-mcp": "^1.0.26"
+	},
+	"devDependencies": {
+		"@types/node": "^20.11.0",
+		"typescript": "^5.3.3"
+	}
+}