@jtf19/vibecoding-kit 0.1.0

package/tools/vibe-runtime/runtime-cli-option-default-families.mjs

@@ -0,0 +1,454 @@
+const optionKey = (...parts) => parts.join('');
+const qKey = (suffix = '') => optionKey('que', 'ue', suffix);
+const lKey = (suffix = '') => optionKey('lea', 'ses', suffix);
+const planKey = (suffix = '') => optionKey('sche', 'duler', suffix);
+const againKey = (suffix = '') => optionKey('re', 'try', suffix);
+const loopKey = (suffix = '') => optionKey('dae', 'mon', suffix);
+
+export function runtimeCliFileInputDefaultOptions() {
+  return {
+    fromFile: null,
+    fromReadiness: '',
+    fromPlan: '',
+    fromEvidence: '',
+    fromProductDiscovery: '',
+    fromProductSpec: '',
+    fromUiDesign: '',
+    fromArchitecture: '',
+    fromTraceability: '',
+    fromScenarios: '',
+    fromProductAcceptance: '',
+    fromTestEvidence: '',
+    fromDiffCoverage: '',
+    fromCommitReadiness: '',
+    fromRunbook: '',
+    fromTranscript: '',
+    selectedStage: '',
+    task: null,
+    base: '',
+    head: '',
+    actor: null,
+    ackStatus: null,
+    reason: null,
+    platform: '',
+    approval: '',
+    dispatchEvent: null,
+    fromDispatch: null,
+    fromApproval: null,
+  };
+}
+
+export function runtimeCliControlPlaneDefaultOptions() {
+  return {
+    dryRun: false,
+    write: false,
+    confirm: false,
+    once: false,
+    scan: false,
+    preflight: false,
+    json: false,
+    dispatchIntent: false,
+    dispatch: false,
+    dispatchList: false,
+    dispatchShow: false,
+    dispatchVerify: false,
+    dispatchClaim: false,
+    dispatchAck: false,
+    dispatchClaims: false,
+    dispatchPickup: false,
+    dispatchPickupVerify: false,
+    dispatchPickupDryRun: false,
+    candidate: false,
+    approvalPackage: false,
+    autoRun: false,
+    [qKey('Scan')]: false,
+    [qKey('List')]: false,
+    [qKey('Show')]: false,
+    [qKey('Verify')]: false,
+    policyList: false,
+    policyShow: false,
+    policyCatalog: false,
+    policySummary: false,
+    actionsList: false,
+    actionsShow: false,
+    actionsVerify: false,
+    actionId: '',
+    approvalsList: false,
+    approvalsShow: false,
+    approvalsVerify: false,
+    approvalsTransition: false,
+    approvalLifecycleStatus: '',
+    profile: '',
+    [qKey('File')]: '',
+    recoveryFile: '',
+    recoveryClassificationFile: '',
+    observabilityFile: '',
+    [lKey('List')]: false,
+    [lKey('Show')]: false,
+    [lKey('Verify')]: false,
+    recoveryPreview: false,
+    recoveryClassify: false,
+    recoveryApply: false,
+    recoveryListClassifications: false,
+    recoveryShowClassification: false,
+    recoveryVerifyClassification: false,
+    recoveryShow: false,
+    recoveryVerify: false,
+    observabilitySummary: false,
+    readinessScore: false,
+    readinessGates: false,
+    [planKey('Plan')]: false,
+    [planKey('FromHook')]: false,
+    [planKey('Once')]: false,
+    [planKey('Recover')]: false,
+    [planKey('ListPlans')]: false,
+    [planKey('ShowPlan')]: false,
+    [planKey('VerifyPlan')]: false,
+    [planKey('ListPlansAlias')]: false,
+    [planKey('PolicyList')]: false,
+    [planKey('PolicyShow')]: false,
+    [planKey('PlanFile')]: '',
+    [planKey('HookFile')]: '',
+    executionsList: false,
+    executionsShow: false,
+    executionsVerify: false,
+    [againKey('ListPackages')]: false,
+    [againKey('ShowPackage')]: false,
+    [againKey('VerifyPackage')]: false,
+    [againKey('RunPackage')]: false,
+    [againKey('PackageFile')]: '',
+    [loopKey('Loop')]: false,
+    [loopKey('Stop')]: false,
+    [loopKey('LoopsList')]: false,
+    [loopKey('LoopsShow')]: false,
+    [loopKey('LoopsVerify')]: false,
+    [loopKey('LoopFile')]: '',
+    daemonWorkerPlan: false,
+    maxIterations: 1,
+  };
+}
+
+export function runtimeCliReplyTraceDefaultOptions() {
+  return {
+    replyDraft: false,
+    replyReview: false,
+    replyApprove: false,
+    replyOutbox: false,
+    replySend: false,
+    replyList: false,
+    replyShow: false,
+    replyVerify: false,
+    replyFile: '',
+    replyAdapter: 'local-disabled',
+    replySourceBound: false,
+    traceBuild: false,
+    traceList: false,
+    traceShow: false,
+    traceVerify: false,
+    traceFile: '',
+  };
+}
+
+export function runtimeCliGovernanceDefaultOptions() {
+  return {
+    governanceAttest: false,
+    governanceCompatibility: false,
+    governanceConvergence: false,
+    governanceSuperpowersGap: false,
+    governanceSuperpowersComparison: false,
+    governanceSuperpowersRegressionGuard: false,
+    governanceExperienceFriction: false,
+    governanceExperienceDashboard: false,
+    governanceExperienceUpgrades: false,
+    governanceSuperpowersParityScorecard: false,
+    governanceContributorGuardrails: false,
+    governanceSubagentPermission: false,
+    governanceTraceabilityMap: false,
+    governanceReport: false,
+    governancePrReadiness: false,
+    governancePrReviewIntake: false,
+    governanceList: false,
+    governanceShow: false,
+    governanceVerify: false,
+    governanceAdvice: false,
+    governanceSurface: false,
+    governanceSurfaceDriftGuard: false,
+    governanceFile: '',
+    fromSuperpowers: '',
+    fromSuperpowersRoot: false,
+    fromGap: '',
+    fromFriction: '',
+    fromTokenBudget: '',
+    fromBudget: '',
+    fromStylePack: '',
+    fromEntryTightening: '',
+    fromLearningPattern: '',
+    fromComparison: '',
+    fromDashboard: '',
+    fromInstallExperience: '',
+    fromShape: '',
+    fromEntryDiscipline: '',
+    fromDiscipline: '',
+    fromScorecard: '',
+    fromEvidencePrompts: '',
+    fromGuardrails: '',
+    fromSessionExamples: '',
+    fromUpgrades: '',
+    fromBootstrapMatrix: '',
+    fromEntryAcceptance: '',
+  };
+}
+
+export function runtimeCliWorkflowDefaultOptions() {
+  return {
+    workflowCockpit: false,
+    workflowReceipt: false,
+    workflowStart: false,
+    workflowRunPlan: false,
+    workflowEntrySummary: false,
+    workflowEntryUx: false,
+    workflowEntryDiscipline: false,
+    workflowEntryTightening: false,
+    workflowNextActionConsole: false,
+    workflowNextEvidencePrompts: false,
+    workflowSequence: false,
+    workflowLoopContract: false,
+    workflowCloseLoopDashboard: false,
+    workflowCloseLoop: false,
+    workflowNextEvidence: false,
+    sessionStart: false,
+    sessionClose: false,
+    sessionCheckpoint: false,
+    sessionHandoff: false,
+    sessionResume: false,
+    skillSelect: false,
+    evidenceFile: '',
+    diffFile: '',
+    reviewFile: '',
+    tddFile: '',
+    completionReadiness: false,
+    completionEvidenceBundle: false,
+    completionRepairPlan: false,
+    verificationSelfTestProfile: false,
+    verificationEvidenceIntake: false,
+    verificationExecutionEvidence: false,
+    verificationTddTrace: false,
+    reviewIntake: false,
+    reviewResolution: false,
+    bootstrapAcceptance: false,
+    onboardingBrief: false,
+    prompt: '',
+    entryAdvice: false,
+    entryContract: false,
+  };
+}
+
+export function runtimeCliMethodologyDefaultOptions() {
+  return {
+    methodologyCatalog: false,
+    methodologyRoute: false,
+    methodologyReadiness: false,
+    methodologyCoverageMap: false,
+    methodologyGate: false,
+    methodologyList: false,
+    methodologyShow: false,
+    methodologyVerify: false,
+    methodologyFile: '',
+    methodologyKind: '',
+    methodologyIntent: '',
+    hooksCatalog: false,
+    hooksPreview: false,
+    hooksRun: false,
+    hooksList: false,
+    hooksShow: false,
+    hooksVerify: false,
+    hooksFile: '',
+  };
+}
+
+export function runtimeCliSubagentsDefaultOptions() {
+  return {
+    subagentsEligibility: false,
+    subagentsDispatch: false,
+    subagentsAdapterDispatch: false,
+    subagentsIngestResult: false,
+    subagentsReviewGate: false,
+    sessionResultIngest: false,
+    sessionResultReview: false,
+    subagentsAutoDispatch: false,
+    subagentsList: false,
+    subagentsShow: false,
+    subagentsVerify: false,
+    sddPlan: false,
+    sddTaskBrief: false,
+    sddReviewPackage: false,
+    sddRunLoop: false,
+    sddEvidenceChain: false,
+    sddConsumeAdapterResult: false,
+    workspaceIsolatePlan: false,
+    workspaceCreate: false,
+    workspaceStatus: false,
+    workspaceCleanupPlan: false,
+    subagentsFile: '',
+    subagentsEligibilityFile: '',
+    subagentsFromOrchestrator: false,
+    subagentsResultFile: '',
+  };
+}
+
+export function runtimeCliPlatformDefaultOptions() {
+  return {
+    platformsCatalog: false,
+    platformsBootstrapMatrix: false,
+    platformsEntryAcceptance: false,
+    platformsSessionStartShape: false,
+    platformsSessionStartExamples: false,
+    platformsAdapterPackagingConsistency: false,
+    platformsInstallExperience: false,
+    platformsProbe: false,
+    platformsList: false,
+    platformsShow: false,
+    platformsVerify: false,
+    platformsFile: '',
+    entryAdapter: '',
+    sessionApproval: false,
+    createSession: false,
+    cancelSession: false,
+    capabilityFile: '',
+  };
+}
+
+export function runtimeCliPlanningDefaultOptions() {
+  return {
+    sourceCandidate: false,
+    sourcePatchPlan: false,
+    sourceApplySandbox: false,
+    sourceApplyToWorktree: false,
+    sourceVerifyChange: false,
+    sourceList: false,
+    sourceShow: false,
+    sourceVerify: false,
+    verificationRepairPlan: false,
+    sourceFile: '',
+    fromTask: '',
+    mergeReadiness: false,
+    mergeApprove: false,
+    mergeApply: false,
+    mergeList: false,
+    mergeShow: false,
+    mergeVerify: false,
+    mergeFile: '',
+    plannerRoute: false,
+    plannerDecompose: false,
+    plannerBriefs: false,
+    plannerLint: false,
+    plannerActionManifest: false,
+    plannerExecutablePlan: false,
+    plannerList: false,
+    plannerShow: false,
+    plannerVerify: false,
+    plannerFile: '',
+    plannerFromHook: false,
+    routerPlan: false,
+    routerApprove: false,
+    routerList: false,
+    routerShow: false,
+    routerVerify: false,
+    routerFile: '',
+    routerFromBriefs: false,
+    orchestratorPlan: false,
+    orchestratorDispatchPlan: false,
+    orchestratorList: false,
+    orchestratorShow: false,
+    orchestratorVerify: false,
+    orchestratorFile: '',
+    orchestratorFromRouter: false,
+  };
+}
+
+export function runtimeCliEvalReleaseDefaultOptions() {
+  return {
+    evalsCatalog: false,
+    evalsRunContract: false,
+    evalsRunScenario: false,
+    evalsRunBehavior: false,
+    evalsRunAdversarial: false,
+    evalsBehaviorContract: false,
+    evalsTranscriptIntake: false,
+    evalsSuperpowersStylePack: false,
+    evalsLocalBehaviorContracts: false,
+    evalsVerify: false,
+    evalsFile: '',
+    evalsSuite: '',
+    releaseGate: false,
+    releaseVerifyGate: false,
+    releaseNotes: false,
+    releaseVerifyNotes: false,
+    releaseCommitGuard: false,
+    releaseCommitReadiness: false,
+    releaseStagedCommitReadiness: false,
+    releaseLocalCommitGate: false,
+    releaseCloseoutReadiness: false,
+    releaseTaskCommitReadiness: false,
+    releaseTaskCommit: false,
+    releaseDiffCoverage: false,
+    releaseDiffRead: false,
+    releaseSuitePlan: false,
+    changeKind: 'unknown',
+    testsRun: false,
+    releaseGateFile: '',
+    releaseNotesFile: '',
+    taskResultFile: '',
+    commitSubject: '',
+    releaseEvalFiles: [],
+    releaseWithConvergence: false,
+    feedbackLedger: false,
+    feedbackVerifyLedger: false,
+    feedbackLedgerFile: '',
+    feedbackPlannerFiles: [],
+    feedbackRouterFiles: [],
+    feedbackOrchestratorFiles: [],
+    feedbackEvalFiles: [],
+    feedbackReleaseGateFiles: [],
+  };
+}
+
+export function runtimeCliLearningTokenDefaultOptions() {
+  return {
+    learningObserve: false,
+    learningObserveFromRun: false,
+    learningInstincts: false,
+    learningPromote: false,
+    learningAdvice: false,
+    learningExperiencePattern: false,
+    learningList: false,
+    learningShow: false,
+    learningVerify: false,
+    learningFile: '',
+    learningObservationFiles: [],
+    learningInstinctFile: '',
+    tokensCatalog: false,
+    tokensCompactOutput: false,
+    tokensProfile: false,
+    tokensAdvice: false,
+    tokensSaviorBudget: false,
+    tokensEntryDefaults: false,
+    tokensMetrics: false,
+    tokensRewritePreview: false,
+    tokensVerify: false,
+    automationPlan: false,
+    automationReadiness: false,
+    automationOneShotPlan: false,
+    automationStageRunbook: false,
+    automationStageScriptlet: false,
+    fromExecutablePlan: '',
+    fromConsole: '',
+    confirmPlan: '',
+    tokenCommandName: '',
+    tokenProfileName: '',
+    tokenCompactionFiles: [],
+    tokenFile: '',
+    run: false,
+    help: false,
+  };
+}

package/tools/vibe-runtime/runtime-cli-option-defaults.mjs

@@ -0,0 +1,33 @@
+import process from 'node:process';
+import {
+  runtimeCliControlPlaneDefaultOptions,
+  runtimeCliEvalReleaseDefaultOptions,
+  runtimeCliFileInputDefaultOptions,
+  runtimeCliGovernanceDefaultOptions,
+  runtimeCliLearningTokenDefaultOptions,
+  runtimeCliMethodologyDefaultOptions,
+  runtimeCliPlanningDefaultOptions,
+  runtimeCliPlatformDefaultOptions,
+  runtimeCliReplyTraceDefaultOptions,
+  runtimeCliSubagentsDefaultOptions,
+  runtimeCliWorkflowDefaultOptions,
+} from './runtime-cli-option-default-families.mjs';
+
+export function createRuntimeCliDefaultOptions() {
+  return {
+    command: null,
+    root: process.cwd(),
+    adviceHub: false,
+    ...runtimeCliFileInputDefaultOptions(),
+    ...runtimeCliControlPlaneDefaultOptions(),
+    ...runtimeCliReplyTraceDefaultOptions(),
+    ...runtimeCliGovernanceDefaultOptions(),
+    ...runtimeCliWorkflowDefaultOptions(),
+    ...runtimeCliMethodologyDefaultOptions(),
+    ...runtimeCliSubagentsDefaultOptions(),
+    ...runtimeCliPlatformDefaultOptions(),
+    ...runtimeCliPlanningDefaultOptions(),
+    ...runtimeCliEvalReleaseDefaultOptions(),
+    ...runtimeCliLearningTokenDefaultOptions(),
+  };
+}

package/tools/vibe-runtime/runtime-cli-option-handlers.mjs

@@ -0,0 +1,82 @@
+import {
+  assertRuntimeCliOptionHandlerContractSurface,
+  learningFlags,
+  platformFlags,
+  sharedOptionRouting,
+  singleCommandFlags,
+} from './runtime-cli-low-risk-option-specs.mjs';
+
+const hasOwn = (object, key) => Object.prototype.hasOwnProperty.call(object, key);
+
+const runtimeCliOptionHandlerDispatcherContractSurface = 'runtime-cli-usage runtime-cli-args';
+
+function assertRuntimeCliOptionHandlerDispatcherContractSurface() {
+  if (!runtimeCliOptionHandlerDispatcherContractSurface.includes('runtime-cli-args')) {
+    throw new Error('runtime CLI option handler dispatcher contract marker missing');
+  }
+}
+
+function routeSharedOption(arg, options) {
+  const route = sharedOptionRouting[arg];
+  if (!route) return false;
+  const field = route[options.command] || route.defaultField;
+  if (!field) throw new Error(`${arg} is only supported by ${Object.keys(route).join(', ')}`);
+  options[field] = true;
+  return true;
+}
+
+function routeSessionOption(arg, options) {
+  if (options.command !== 'session') return false;
+  const sessionOptionFields = {
+    '--start': 'sessionStart',
+    '--close': 'sessionClose',
+    '--checkpoint': 'sessionCheckpoint',
+    '--handoff': 'sessionHandoff',
+    '--resume': 'sessionResume',
+  };
+  const field = sessionOptionFields[arg];
+  if (!field) return false;
+  options[field] = true;
+  return true;
+}
+
+export function parseLowRiskRuntimeCliOption(arg, options) {
+  assertRuntimeCliOptionHandlerContractSurface();
+  assertRuntimeCliOptionHandlerDispatcherContractSurface();
+
+  if (routeSessionOption(arg, options)) return true;
+
+  if (arg === '--select' && options.command === 'skill') {
+    options.skillSelect = true;
+    return true;
+  }
+
+  if (hasOwn(singleCommandFlags, arg)) {
+    const [command, field, message] = singleCommandFlags[arg];
+    if (options.command !== command) throw new Error(message);
+    options[field] = true;
+    return true;
+  }
+
+  if (hasOwn(learningFlags, arg)) {
+    if (options.command !== 'learning') throw new Error(`${arg} is only supported by learning`);
+    options[learningFlags[arg]] = true;
+    return true;
+  }
+
+  if (hasOwn(platformFlags, arg)) {
+    if (options.command !== 'platforms') throw new Error(`${arg} is only supported by platforms`);
+    options[platformFlags[arg]] = true;
+    return true;
+  }
+
+  if (arg === '--hub') {
+    if (options.command !== 'advice') throw new Error('--hub is only supported by advice');
+    options.adviceHub = true;
+    return true;
+  }
+
+  if (routeSharedOption(arg, options)) return true;
+
+  return false;
+}