Function runSubmoduleMaterialization

src/node/runtime/submoduleSync.ts:75–107

(args: RuntimeSubmoduleSyncArgs)

}

async function runSubmoduleMaterialization(args: RuntimeSubmoduleSyncArgs): Promise<void> {
  const env = buildGitExecutionEnv({ env: args.env, trusted: args.trusted });

  // Skills, docs, and other workspace-managed files can live inside submodules.
  // Materialize them before init hooks or downstream runtime setup so later discovery
  // doesn't misdiagnose missing files as invalid workspace state.
  args.initLogger.logStep("Initializing git submodules...");

  try {
    await runSubmoduleCommand({
      runtime: args.runtime,
      workspacePath: args.workspacePath,
      abortSignal: args.abortSignal,
      env,
      command: SUBMODULE_SYNC_COMMAND,
      timeout: SUBMODULE_SYNC_TIMEOUT_SECS,
      fallbackError: "git submodule sync failed",
    });
    await runSubmoduleCommand({
      runtime: args.runtime,
      workspacePath: args.workspacePath,
      abortSignal: args.abortSignal,
      env,
      command: SUBMODULE_UPDATE_COMMAND,
      timeout: SUBMODULE_UPDATE_TIMEOUT_SECS,
      fallbackError: "git submodule update failed",
    });
  } catch (error) {
    throw formatSubmoduleSyncError(error);
  }

  args.initLogger.logStep("Git submodules ready");
}

async function hasLocalGitmodules(workspacePath: string): Promise<boolean> {
  const gitmodulesPath = path.join(workspacePath, ".gitmodules");