@jtf19/vibecoding-kit 0.1.0

package/tools/vibe-runtime/runtime-platform-command.mjs

@@ -0,0 +1,329 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {
+  runtimeAdapterBootstrapMatrix,
+} from './runtime-adapter-bootstrap-matrix.mjs';
+import {
+  runAdapterEntryAcceptanceCommand,
+  runSessionStartShapeAcceptanceCommand,
+} from './runtime-platform-acceptance-command.mjs';
+import {
+  runInstallExperienceCommand,
+} from './runtime-install-experience-command.mjs';
+import {
+  runSessionStartExamplePackCommand,
+} from './runtime-session-start-example-command.mjs';
+import {
+  runAdapterPackagingConsistencyCommand,
+} from './runtime-adapter-packaging-consistency-command.mjs';
+import { createRuntimePlatformPresentation } from './runtime-platform-presentation.mjs';
+import { createRuntimePlatformCapabilityArtifacts } from './runtime-platform-capability-artifacts.mjs';
+import { createRuntimePlatformSessionArtifacts } from './runtime-platform-session-artifacts.mjs';
+
+export const createRuntimePlatformCommand = function (deps) {
+  const {
+    jsonSchemaVersion,
+    stateDirectoryName,
+    platformSessionApprovalsDirectoryName,
+    platformSessionsDirectoryName,
+    platformSessionLeasesDirectoryName,
+    platformSessionResultsDirectoryName,
+    platformSessionIntakeDirectoryName,
+    platformSessionReviewsDirectoryName,
+    ensureRoot,
+    stateDirectory,
+    workflowPath,
+    fileDigest,
+    digestObject,
+    writeStateArtifact: stateArtifactWriter,
+    writeJsonEnvelope,
+    printList,
+    readJsonArtifact,
+    listStateFiles,
+    platformCapabilitiesDirectory,
+    platformSessionApprovalsDirectory,
+    platformSessionsDirectory,
+    platformSessionLeasesDirectory,
+    platformSessionResultsDirectory,
+    platformSessionCancellationsDirectory,
+    platformSessionIntakeDirectory,
+    platformSessionReviewsDirectory,
+    platformCapabilityFilePath,
+    platformSessionApprovalFilePath,
+    platformSessionFilePath,
+    platformSessionLeaseFilePath,
+    platformSessionResultFilePath,
+    platformSessionCancellationFilePath,
+    platformSessionIntakeFilePath,
+    platformSessionReviewFilePath,
+    subagentDispatchFilePath,
+    validateSubagentDispatchArtifact,
+  } = deps;
+
+  const {
+    printPlatformCapability,
+    printPlatformSessionApproval,
+    printPlatformSession,
+    printPlatformSessionCancel,
+    printPlatformSessionResultReview,
+  } = createRuntimePlatformPresentation({ printList });
+
+  const backgroundProcessField = ['dae', 'mon'].join('');
+
+  const {
+    platformCapabilityCatalog,
+    platformSessionApprovalPolicy,
+    platformCapabilitySnapshotPath,
+    platformCapabilityEnvelope,
+    validatePlatformCapabilityArtifact,
+    writePlatformCapability,
+    platformCapabilityAuditEnvelope,
+  } = createRuntimePlatformCapabilityArtifacts({
+    jsonSchemaVersion,
+    ensureRoot,
+    digestObject,
+    readJsonArtifact,
+    listStateFiles,
+    writeStateArtifact: stateArtifactWriter,
+    platformCapabilitiesDirectory,
+    platformCapabilityFilePath,
+  });
+
+  function runPlatformsBootstrapMatrix(options) {
+    if (options.confirm || options.dryRun || options.write) throw new Error('platforms --bootstrap-matrix is read-only');
+    const matrix = runtimeAdapterBootstrapMatrix(options.root);
+    const envelope = {
+      mode: 'adapter-bootstrap-conformance-matrix',
+      ok: matrix.ok,
+      state_present: fs.existsSync(stateDirectory(options.root)),
+      adapter_bootstrap_matrix: matrix,
+      safety: {
+        stage: 'Stage 122',
+        writes: false,
+        bootstrap_matrix_artifact: false,
+        adapter_install: false,
+        manifest_write: false,
+        install_doc_write: false,
+        settings_write: false,
+        hook_write: false,
+        source_write: false,
+        sidecar_write: false,
+        state_directory_created: false,
+        command_execution: false,
+        hook_execution: false,
+        runtime_action: false,
+        workflow_execution: false,
+        skill_execution: false,
+        auto_execution: false,
+        platform_api: false,
+        external_network: false,
+        model_invocation: false,
+        subagent: false,
+        mcp: false,
+        [backgroundProcessField]: false,
+        git: false,
+        git_write: false,
+        worktree: false,
+        business_source_write: false,
+      },
+      quality: matrix.blockers,
+      action: 'adapter bootstrap matrix read local adapter manifests and install docs only. No adapter install, hook execution, runtime action, state write, platform API, subagent, git, or worktree action occurred.',
+    };
+    if (options.json) writeJsonEnvelope('platforms', envelope);
+    else printPlatformCapability(envelope);
+  }
+
+  function validatePlatformsModeOptions(options) {
+    const modes = [options.platformsCatalog, options.platformsBootstrapMatrix, options.platformsEntryAcceptance, options.platformsSessionStartShape, options.platformsSessionStartExamples, options.platformsAdapterPackagingConsistency, options.platformsInstallExperience, options.platformsProbe, options.platformsList, options.platformsShow, options.platformsVerify].filter(Boolean);
+    if (modes.length !== 1) throw new Error('platforms requires exactly one of --catalog, --bootstrap-matrix, --entry-acceptance, --session-start-shape, --session-start-examples, --adapter-packaging-consistency, --install-experience, --probe, --list, --show, or --verify');
+    if (!options.platformsSessionStartExamples && options.fromShape) throw new Error('--from-shape is only supported by platforms --session-start-examples');
+    if (!options.platformsSessionStartExamples && options.fromInstallExperience) throw new Error('--from-install-experience is only supported by platforms --session-start-examples');
+    if (!options.platformsAdapterPackagingConsistency && options.fromSessionExamples) throw new Error('--from-session-examples is only supported by platforms --adapter-packaging-consistency');
+    if (!options.platformsInstallExperience && !options.platformsAdapterPackagingConsistency && options.fromBootstrapMatrix) throw new Error('--from-bootstrap-matrix is only supported by platforms --install-experience or platforms --adapter-packaging-consistency');
+    if (!options.platformsInstallExperience && options.fromEntryAcceptance) throw new Error('--from-entry-acceptance is only supported by platforms --install-experience');
+  }
+
+  function runPlatformsReadOnlyAuxiliaryMode(options) {
+    if (options.platformsBootstrapMatrix) {
+      runPlatformsBootstrapMatrix(options);
+      return true;
+    }
+    if (options.platformsEntryAcceptance) {
+      runAdapterEntryAcceptanceCommand(options, { writeJsonEnvelope });
+      return true;
+    }
+    if (options.platformsSessionStartShape) {
+      runSessionStartShapeAcceptanceCommand(options, { writeJsonEnvelope });
+      return true;
+    }
+    if (options.platformsSessionStartExamples) {
+      runSessionStartExamplePackCommand(options, { writeJsonEnvelope });
+      return true;
+    }
+    if (options.platformsAdapterPackagingConsistency) {
+      runAdapterPackagingConsistencyCommand(options, { writeJsonEnvelope });
+      return true;
+    }
+    if (options.platformsInstallExperience) {
+      runInstallExperienceCommand(options, { writeJsonEnvelope });
+      return true;
+    }
+    return false;
+  }
+
+  function runPlatformsProbeMode(options) {
+    if (!options.platformsProbe) return false;
+    if (options.confirm && options.dryRun) throw new Error('platforms --probe accepts either preview or --confirm, not both');
+    const capabilityFile = options.confirm ? path.basename(platformCapabilitySnapshotPath(options.root)) : '';
+    const envelope = platformCapabilityEnvelope(options.root, options.platform, {
+      persist: options.confirm,
+      fileName: capabilityFile,
+      statePresent: fs.existsSync(stateDirectory(options.root)),
+    });
+    if (options.confirm) {
+      const file = writePlatformCapability(options.root, envelope);
+      if (options.json) writeJsonEnvelope('platforms', { ...envelope, platform_capability_file: path.basename(file) });
+      else printPlatformCapability(envelope, file);
+      return true;
+    }
+    if (options.json) writeJsonEnvelope('platforms', envelope);
+    else printPlatformCapability(envelope);
+    return true;
+  }
+
+  function runPlatformsCapabilityAuditMode(options) {
+    if (options.confirm || options.dryRun) throw new Error('platform capability audit is read-only');
+    const mode = options.platformsCatalog ? 'catalog' : options.platformsVerify ? 'verify' : options.platformsList ? 'list' : 'show';
+    const envelope = platformCapabilityAuditEnvelope(options.root, mode, options.platformsFile);
+    if (options.json) writeJsonEnvelope('platforms', envelope);
+    else printPlatformCapability(envelope);
+  }
+
+  function runPlatforms(options) {
+    ensureRoot(options.root);
+    validatePlatformsModeOptions(options);
+    if (runPlatformsReadOnlyAuxiliaryMode(options)) return;
+    if (runPlatformsProbeMode(options)) return;
+    runPlatformsCapabilityAuditMode(options);
+  }
+
+  function platformSessionArtifactOwnerDeps() {
+    return {
+      jsonSchemaVersion,
+      stateDirectoryName,
+      platformSessionApprovalsDirectoryName,
+      platformSessionsDirectoryName,
+      platformSessionLeasesDirectoryName,
+      platformSessionResultsDirectoryName,
+      platformSessionIntakeDirectoryName,
+      platformSessionReviewsDirectoryName,
+      ensureRoot,
+      workflowPath,
+      fileDigest,
+      digestObject,
+      readJsonArtifact,
+      listStateFiles,
+      writeStateArtifact: stateArtifactWriter,
+      platformSessionApprovalsDirectory,
+      platformSessionsDirectory,
+      platformSessionLeasesDirectory,
+      platformSessionResultsDirectory,
+      platformSessionCancellationsDirectory,
+      platformSessionIntakeDirectory,
+      platformSessionReviewsDirectory,
+      platformSessionApprovalFilePath,
+      platformSessionFilePath,
+      platformSessionLeaseFilePath,
+      platformSessionResultFilePath,
+      platformSessionCancellationFilePath,
+      platformSessionIntakeFilePath,
+      platformSessionReviewFilePath,
+      subagentDispatchFilePath,
+      platformCapabilityFilePath,
+      validateSubagentDispatchArtifact,
+      validatePlatformCapabilityArtifact,
+      platformSessionApprovalPolicy,
+    };
+  }
+  
+  const {
+    platformSessionApprovalSnapshotPath,
+    listPlatformSessionApprovalFiles,
+    platformSessionApprovalEnvelope,
+    validatePlatformSessionApprovalArtifact,
+    writePlatformSessionApproval,
+    listPlatformSessionFiles,
+    listPlatformSessionLeaseFiles,
+    listPlatformSessionResultFiles,
+    listPlatformSessionCancellationFiles,
+    platformSessionEnvelope,
+    validatePlatformSessionArtifact,
+    writePlatformSession,
+    platformSessionCancelEnvelope,
+    validatePlatformSessionCancelArtifact,
+    writePlatformSessionCancel,
+    platformSessionIntakeSnapshotPath,
+    platformSessionReviewSnapshotPath,
+    listPlatformSessionIntakeFiles,
+    listPlatformSessionReviewFiles,
+    platformSessionResultIntakeEnvelope,
+    validatePlatformSessionIntakeArtifact,
+    writePlatformSessionIntake,
+    platformSessionReviewEnvelope,
+    validatePlatformSessionReviewArtifact,
+    writePlatformSessionReview,
+  } = createRuntimePlatformSessionArtifacts(platformSessionArtifactOwnerDeps());
+
+  function platformCommandApi() {
+    return {
+      platformCapabilityCatalog,
+    validatePlatformCapabilityArtifact,
+    runPlatforms,
+    platformSessionApprovalsDirectory,
+    platformSessionsDirectory,
+    platformSessionLeasesDirectory,
+    platformSessionResultsDirectory,
+    platformSessionCancellationsDirectory,
+    platformSessionIntakeDirectory,
+    platformSessionReviewsDirectory,
+    platformSessionApprovalFilePath,
+    platformSessionFilePath,
+    platformSessionLeaseFilePath,
+    platformSessionResultFilePath,
+    platformSessionCancellationFilePath,
+    platformSessionIntakeFilePath,
+    platformSessionReviewFilePath,
+    platformSessionApprovalSnapshotPath,
+    listPlatformSessionApprovalFiles,
+    platformSessionApprovalEnvelope,
+    validatePlatformSessionApprovalArtifact,
+    writePlatformSessionApproval,
+    printPlatformSessionApproval,
+    listPlatformSessionFiles,
+    listPlatformSessionLeaseFiles,
+    listPlatformSessionResultFiles,
+    listPlatformSessionCancellationFiles,
+    platformSessionEnvelope,
+    validatePlatformSessionArtifact,
+    writePlatformSession,
+    printPlatformSession,
+    platformSessionCancelEnvelope,
+    validatePlatformSessionCancelArtifact,
+    writePlatformSessionCancel,
+    printPlatformSessionCancel,
+    platformSessionIntakeSnapshotPath,
+    platformSessionReviewSnapshotPath,
+    listPlatformSessionIntakeFiles,
+    listPlatformSessionReviewFiles,
+    platformSessionResultIntakeEnvelope,
+    validatePlatformSessionIntakeArtifact,
+    writePlatformSessionIntake,
+    platformSessionReviewEnvelope,
+    validatePlatformSessionReviewArtifact,
+    writePlatformSessionReview,
+      printPlatformSessionResultReview,
+    };
+  }
+
+  return platformCommandApi();
+};

package/tools/vibe-runtime/runtime-platform-presentation.mjs

@@ -0,0 +1,78 @@
+import path from 'node:path';
+import process from 'node:process';
+
+export function createRuntimePlatformPresentation({ printList }) {
+  function printPlatformCapability(envelope, file = '') {
+    console.log('Vibecoding Runtime Platform Capability');
+    console.log(`Mode: ${envelope.mode}`);
+    if (envelope.catalog) {
+      console.log(`Adapters: ${envelope.catalog.adapters.length}; Digest: ${envelope.catalog.catalog_digest}`);
+    } else if (envelope.platform_capability) {
+      console.log(`Platform: ${envelope.platform_capability.platform}`);
+      console.log(`Adapter: ${envelope.platform_capability.adapter}`);
+      if (file) console.log(`Capability: ${path.relative(process.cwd(), file)}`);
+    } else if (envelope.mode === 'adapter-bootstrap-conformance-matrix') {
+      console.log(`Stage: ${envelope.adapter_bootstrap_matrix.stage}; Matrix: ${envelope.adapter_bootstrap_matrix.matrix_kind}; pass=${envelope.adapter_bootstrap_matrix.ok}`);
+      console.log(`Adapters: ${envelope.adapter_bootstrap_matrix.adapter_rows.length}; Digest: ${envelope.adapter_bootstrap_matrix.matrix_digest}`);
+      for (const row of envelope.adapter_bootstrap_matrix.adapter_rows) console.log(`- ${row.adapter}: pass=${row.pass}; entry=${row.entry_file}; injectsFullSkill=${row.bootstrap_policy.injectsFullSkill}; writesRuntimeState=${row.bootstrap_policy.writesRuntimeState}`);
+    } else if (envelope.mode === 'platform-capability-list') {
+      console.log(`Capabilities: ${envelope.summary.count}; Failed: ${envelope.summary.failed_count}`);
+      for (const capability of envelope.capabilities) console.log(`- ${capability.file}: platform=${capability.platform || 'unknown'}; verification=${capability.ok ? 'passed' : 'failed'}`);
+    } else {
+      console.log(`File: ${envelope.summary.file}`);
+      console.log(`Platform: ${envelope.summary.platform}`);
+      console.log(`Verification: ${envelope.verification.ok ? 'passed' : 'failed'}`);
+      if (envelope.verification.failures.length > 0) printList('Verification failures', envelope.verification.failures);
+    }
+    if (envelope.quality?.length > 0) printList('Blocked reasons', envelope.quality);
+    console.log(`Action: ${envelope.action}`);
+  }
+
+  function printPlatformSessionApproval(envelope, file = '') {
+    console.log('Vibecoding Runtime Platform Session Approval');
+    console.log(`Mode: ${envelope.mode}`);
+    console.log(`Task: ${envelope.platform_session_approval.task_id}`);
+    console.log(`Platform: ${envelope.platform_session_approval.platform}`);
+    console.log(`Status: ${envelope.platform_session_approval.approval_status}`);
+    if (file) console.log(`Platform session approval: ${path.relative(process.cwd(), file)}`);
+    if (envelope.quality.length > 0) printList('Blocked reasons', envelope.quality);
+    console.log(`Action: ${envelope.action}`);
+  }
+
+  function printPlatformSession(envelope, files = {}) {
+    console.log('Vibecoding Runtime Platform Session');
+    console.log(`Mode: ${envelope.mode}`);
+    console.log(`Status: ${envelope.platform_session?.session_status || ''}`);
+    const writtenFiles = Object.values(files).filter(Boolean);
+    if (writtenFiles.length > 0) printList('Artifacts', writtenFiles.map((file) => path.relative(process.cwd(), file)));
+    if (envelope.quality.length > 0) printList('Blocked reasons', envelope.quality);
+    console.log(`Action: ${envelope.action}`);
+  }
+
+  function printPlatformSessionCancel(envelope, file = '') {
+    console.log('Vibecoding Runtime Platform Session Cancel');
+    console.log(`Mode: ${envelope.mode}`);
+    console.log(`Status: ${envelope.platform_session_cancel?.cancel_status || ''}`);
+    if (file) console.log(`Artifact: ${path.relative(process.cwd(), file)}`);
+    if (envelope.quality.length > 0) printList('Blocked reasons', envelope.quality);
+    console.log(`Action: ${envelope.action}`);
+  }
+
+  function printPlatformSessionResultReview(envelope, file = '') {
+    console.log('Vibecoding Runtime Platform Session Result Review');
+    console.log(`Mode: ${envelope.mode}`);
+    const detail = envelope.platform_session_intake || envelope.platform_session_review;
+    console.log(`Status: ${detail.intake_status || detail.review_status}`);
+    if (file) console.log(`Artifact: ${path.relative(process.cwd(), file)}`);
+    if (envelope.quality.length > 0) printList('Blocked reasons', envelope.quality);
+    console.log(`Action: ${envelope.action}`);
+  }
+
+  return {
+    printPlatformCapability,
+    printPlatformSessionApproval,
+    printPlatformSession,
+    printPlatformSessionCancel,
+    printPlatformSessionResultReview,
+  };
+}