{"record":{"id":"d0920016d4606215","repo":"abhigyanpatwari/GitNexus","slug":"analyze-watch-does-not-support-unsupported-map-d09200","errorCode":null,"errorMessage":"analyze --watch does not support ${unsupported.map(([name]) => name).join(', ')}","messagePattern":"analyze --watch does not support (.+?)","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"gitnexus/src/cli/analyze-watch.ts","lineNumber":136,"sourceCode":"    ['--skip-git', cli.skipGit],\n    ['--spring-actuator', cli.springActuator],\n    // Rejected under --watch for the same reason as --spring-actuator: the\n    // watcher reacts to source changes, and nothing watches an out-of-band\n    // document directory. Honouring the flag here would read the documents once\n    // and then quietly serve a stale answer for the rest of the session.\n    ['--asyncapi-spec', cli.asyncapiSpec],\n    ['walCheckpointThreshold', cli.walCheckpointThreshold],\n    ['embeddingThreads', cli.embeddingThreads],\n    ['embeddingBatchSize', cli.embeddingBatchSize],\n    ['embeddingSubBatchSize', cli.embeddingSubBatchSize],\n    ['embeddingDevice', cli.embeddingDevice],\n    ['embeddingBaseUrl', cli.embeddingBaseUrl],\n    ['embeddingModel', cli.embeddingModel],\n    ['--embedding-auth-token', cli.embeddingAuthToken],\n    ['--embedding-dims', cli.embeddingDims],\n  ].filter(([, value]) => value !== undefined && value !== false);\n  if (unsupported.length > 0) {\n    throw new Error(\n      `analyze --watch does not support ${unsupported.map(([name]) => name).join(', ')}`,\n    );\n  }\n  reportIgnoredConfig(\n    [\n      ['embeddings', config.embeddings],\n      ['dropEmbeddings', config.dropEmbeddings],\n      ['defaultBranch', config.defaultBranch],\n      ['skipAgentsMd', config.skipAgentsMd !== undefined],\n      ['skipSkills', config.skipSkills !== undefined],\n      ['stats', config.stats !== undefined],\n      ['springActuator', config.springActuator],\n      ['walCheckpointThreshold', config.walCheckpointThreshold],\n      ['embeddingThreads', config.embeddingThreads],\n      ['embeddingBatchSize', config.embeddingBatchSize],\n      ['embeddingSubBatchSize', config.embeddingSubBatchSize],\n      ['embeddingDevice', config.embeddingDevice],\n      ['embeddingBaseUrl', config.embeddingBaseUrl],","sourceCodeStart":118,"sourceCodeEnd":154,"githubUrl":"https://github.com/abhigyanpatwari/GitNexus/blob/0d1aed942f0e8b5d3bac27519fff441aceea722d/gitnexus/src/cli/analyze-watch.ts#L118-L154","documentation":"resolveWatchOptions() rejects flag/config combinations that `analyze --watch` cannot honor — currently the embedding-related options (embeddingBaseUrl, embeddingModel, --embedding-auth-token, --embedding-dims). If any of them is set (not undefined/false), the command fails fast listing the offending option names, because watch mode does not (re)build embeddings.","triggerScenarios":"Running `gitnexus analyze --watch` while passing --embedding-base-url / --embedding-model / --embedding-auth-token / --embedding-dims on the CLI, or with those keys set in config so they survive the filter as defined values.","commonSituations":"Reusing an analyze invocation script that includes embedding flags, a CI config that sets embedding options globally and then runs watch mode, or forgetting that watch mode skips embedding work.","solutions":["Remove the embedding flags from the watch invocation.","Run a one-shot `gitnexus analyze` (without --watch) when embeddings need to be generated.","Clear the embedding keys from your gitnexus config file or scope them to the non-watch command.","If embeddings should be supported in watch mode, file a feature request."],"exampleFix":"// before\ngitnexus analyze --watch --embedding-base-url https://api.example.com\n// after\ngitnexus analyze --embedding-base-url https://api.example.com\ngitnexus analyze --watch","handlingStrategy":"validation","validationCode":"const embeddingFlags = ['embeddingBaseUrl','embeddingModel','embeddingAuthToken','embeddingDims'];\nif (useWatchMode && embeddingFlags.some(f => cli[f] !== undefined && cli[f] !== false))\n  throw new Error('embedding options are not supported with --watch');","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Keep embedding flags out of watch-mode invocations","Split scripts: one-shot analyze for embeddings, watch for incremental indexing","Audit global config files for embedding keys that leak into watch runs"],"tags":["cli","watch-mode","unsupported-option","embeddings"],"backgroundTag":"unsupported-operation","analyzedSha":"0d1aed942f0e8b5d3bac27519fff441aceea722d","analyzedAt":"2026-09-08T00:40:44.970Z","contentChangedAt":"2026-09-08T00:40:44.970Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}