fix: type annotations, lint fixes, and docs command count update

- client.ts: fix Octokit type in throttle callback (unknown instead of Octokit)
- discussions.ts: add explicit type annotations for GraphQL query variables
- milestones.ts: explicit cast for dueOn parameter
- commands-core.md: update command count to 14 (13 primary + 1 alias)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: maystudios

packages/cli/src/github/client.ts

@@ -23,7 +23,7 @@ export function getOctokit(): Octokit {
   _octokit = new OctokitWithPlugins({
     auth: token,
     throttle: {
-      onRateLimit: (_retryAfter: number, _options: Record<string, unknown>, _oct: Octokit, retryCount: number) => {
+      onRateLimit: (_retryAfter: number, _options: Record<string, unknown>, _oct: unknown, retryCount: number) => {
         return retryCount < 2;
       },
       onSecondaryRateLimit: () => {

packages/cli/src/github/discussions.ts

@@ -261,9 +261,9 @@ export function listDiscussions(
 
   while (hasNextPage) {
     const afterClause = endCursor ? `, after: $after` : '';
-    const afterVar = endCursor ? ', $after: String!' : '';
+    const afterVar: string = endCursor ? ', $after: String!' : '';
 
-    const query = `
+    const query: string = `
     query($owner: String!, $repo: String!, $first: Int!${hasCategory ? ', $categoryId: ID!' : ''}${afterVar}) {
       repository(owner: $owner, name: $repo) {
         discussions(first: $first${hasCategory ? ', categoryId: $categoryId' : ''}${afterClause}) {
@@ -286,7 +286,7 @@ export function listDiscussions(
     }
   `.trim();
 
-    const args = [
+    const args: string[] = [
       'api', 'graphql',
       '-f', `query=${query}`,
       '-f', `owner=${owner}`,
@@ -302,7 +302,7 @@ export function listDiscussions(
       args.push('-f', `after=${endCursor}`);
     }
 
-    const result = ghJson<{
+    interface DiscussionsResponse {
       data: {
         repository: {
           discussions: {
@@ -311,15 +311,17 @@ export function listDiscussions(
           };
         };
       };
-    }>(args);
+    }
+
+    const result: GhResult<DiscussionsResponse> = ghJson<DiscussionsResponse>(args);
 
     if (!result.ok) return result;
 
     const discussions = result.data?.data?.repository?.discussions;
-    const nodes = discussions?.nodes ?? [];
+    const nodes: RawDiscussion[] = discussions?.nodes ?? [];
     allNodes.push(...nodes);
 
-    const pageInfo = discussions?.pageInfo;
+    const pageInfo: { hasNextPage: boolean; endCursor: string | null } | undefined = discussions?.pageInfo;
     hasNextPage = pageInfo?.hasNextPage ?? false;
     endCursor = pageInfo?.endCursor ?? null;
   }

packages/cli/src/github/milestones.ts

@@ -130,7 +130,7 @@ export async function updateMilestone(
       title: params.title,
       description: params.description,
       state: params.state,
-      due_on: params.dueOn,
+      due_on: params.dueOn as string | undefined,
     });
 
     return {

packages/website/src/content/docs/commands-core.md

@@ -4,7 +4,7 @@ title: Core Commands
 group: Commands Reference
 ---
 
-MaxsimCLI provides 13 commands, each mapped to a slash command inside Claude Code. Every command dispatches one or more subagents with fresh context windows, reads state from GitHub, and writes results back to GitHub.
+MaxsimCLI provides 14 commands (13 primary + 1 alias), each mapped to a slash command inside Claude Code. Every command dispatches one or more subagents with fresh context windows, reads state from GitHub, and writes results back to GitHub.
 
 ### Command overview