{"record":{"id":"49cdb889ba802a53","repo":"affaan-m/ECC","slug":"usage-legacy-sync-state-js-begin-record-finalize","errorCode":null,"errorMessage":"Usage: legacy-sync-state.js <begin|record|finalize|rollback> [options]","messagePattern":"Usage: legacy-sync-state\\.js <begin\\|record\\|finalize\\|rollback> \\[options\\]","errorType":"validation","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"scripts/codex/legacy-sync-state.js","lineNumber":54,"sourceCode":"    if (!statePath || !filePath) throw new Error('record requires --state and --path');\n    recordLegacySyncPath({ statePath, filePath });\n    return;\n  }\n  if (command === 'finalize') {\n    const statePath = readFlag(argv, '--state');\n    if (!statePath) throw new Error('finalize requires --state');\n    finalizeLegacySyncState({ statePath });\n    return;\n  }\n  if (command === 'rollback') {\n    const statePath = readFlag(argv, '--state');\n    if (!statePath) throw new Error('rollback requires --state');\n    const result = rollbackLegacyCodexSync({ statePath });\n    process.stdout.write(`${JSON.stringify(result)}\\n`);\n    if (result.status !== 'rolled-back') process.exitCode = 1;\n    return;\n  }\n  throw new Error('Usage: legacy-sync-state.js <begin|record|finalize|rollback> [options]');\n}\n\nmodule.exports = { main, readFlag };\n\nif (require.main === module) {\n  try {\n    main();\n  } catch (error) {\n    process.stderr.write(`[ecc-sync] ERROR: ${error.message}\\n`);\n    process.exit(1);\n  }\n}\n","sourceCodeStart":36,"sourceCodeEnd":67,"githubUrl":"https://github.com/affaan-m/ECC/blob/8321021c54d670126ce3b2969d5deb880b4b0c2a/scripts/codex/legacy-sync-state.js#L36-L67","documentation":"Printed as a usage error when argv[0] does not match any known subcommand (begin, record, finalize, rollback) in legacy-sync-state.js main; the command string is missing or unrecognized.","triggerScenarios":"Thrown at scripts/codex/legacy-sync-state.js:54 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Run with one of: begin, record, finalize, rollback followed by its required flags.","Check the calling script invokes the right subcommand.","See scripts/lib/codex-legacy-sync for the underlying operations."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8321021c54d670126ce3b2969d5deb880b4b0c2a","analyzedAt":"2026-09-16T10:08:13.343Z","contentChangedAt":"2026-09-16T10:08:13.343Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}