{"record":{"id":"de5a6d67322ef0a5","repo":"abhigyanpatwari/GitNexus","slug":"analyze-watch-does-not-support-unsupported-map","errorCode":null,"errorMessage":"analyze --watch does not support ${unsupported.map(([name]) => name).join(', ')}","messagePattern":"analyze --watch does not support (.+?)","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"gitnexus/src/cli/watch.ts","lineNumber":129,"sourceCode":"    ['--skip-agents-md', cli.skipAgentsMd],\n    ['--skip-skills', cli.skipSkills],\n    ['--no-stats', cli.stats === false],\n    ['--self-commit', cli.selfCommit],\n    ['--index-only', cli.indexOnly],\n    ['--skip-git', cli.skipGit],\n    ['--spring-actuator', cli.springActuator],\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":111,"sourceCodeEnd":147,"githubUrl":"https://github.com/abhigyanpatwari/GitNexus/blob/52924ef12c2290ceee4612526a828ec4cdf2047f/gitnexus/src/cli/watch.ts#L111-L147","documentation":"Thrown by resolveWatchOptions in watch.ts when embedding-related CLI flags are supplied together with `analyze --watch`. Watch mode does not support embedding configuration (embeddingBaseUrl, embeddingModel, --embedding-auth-token, --embedding-dims), and instead of silently ignoring them the CLI fails fast, listing the unsupported flags.","triggerScenarios":"Running `gitnexus analyze --watch --embedding-base-url https://...` (or --embedding-model, --embedding-auth-token, --embedding-dims) with any of those flags set to a value other than undefined/false.","commonSituations":"Reusing an analyze script/command that includes embedding flags and adding --watch; CI configs where watch mode was appended to an existing embedding-enabled analyze invocation; following docs for full analyze and applying it to watch.","solutions":["Remove the embedding flags from the --watch invocation; embeddings are configured for non-watch analyze runs only.","Split the command: run embedding-enabled `analyze` once, then run `analyze --watch` without embedding flags for incremental updates.","If the flags come from a shared script, gate them on a non-watch mode variable or move them into a config file read only by full analyze.","Check reportIgnoredConfig output — if a flag is only informational for watch, drop it rather than passing it."],"exampleFix":"// before\ngitnexus analyze --watch --embedding-base-url http://localhost:8080 --embedding-dims 768\n\n// after\ngitnexus analyze --embedding-base-url http://localhost:8080 --embedding-dims 768\ngitnexus analyze --watch","handlingStrategy":"validation","validationCode":"const watchUnsupported = ['--embedding-base-url', '--embedding-model', '--embedding-auth-token', '--embedding-dims'];\nconst offending = watchUnsupported.filter(f => process.argv.includes(f));\nif (process.argv.includes('--watch') && offending.length) {\n  throw new Error(`analyze --watch does not support ${offending.join(', ')}`);\n}","typeGuard":null,"tryCatchPattern":"try {\n  await runWatchCommand(argv);\n} catch (e) {\n  if (e.message.startsWith('analyze --watch does not support')) {\n    console.error(`${e.message}\\nRun embedding flags in a non-watch analyze pass instead.`);\n    process.exitCode = 2;\n  } else throw e;\n}","preventionTips":["Keep watch invocations in a separate script/target from embedding-enabled analyze runs.","Lint CI definitions for `--watch` combined with embedding flags.","Configure embeddings via the non-watch analyze config surface, not per-invocation flags reused with --watch."],"tags":["cli","watch-mode","unsupported-flag","embeddings"],"backgroundTag":"unsupported-option-combination","analyzedSha":"52924ef12c2290ceee4612526a828ec4cdf2047f","analyzedAt":"2026-09-01T13:15:02.810Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}