@jskit-ai/agent-docs 0.1.1

package/reference/autogen/packages/workspaces-web.md

@@ -0,0 +1,372 @@
+# packages/workspaces-web
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `packages/workspaces-web`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `packages/workspaces-web/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/client/account-settings/accountSettingsInvitesRuntime.js`
+Exports
+- `createAccountSettingsInvitesRuntime({ invitesAvailable, isResolvingInvite, inviteAction, redeemInviteModel, redeemInviteCommand, pendingInvites, pendingInvitesModel, pendingInvitesView, openWorkspace, reportAccountFeedback } = {})`
+
+### `src/client/account-settings/useAccountSettingsInvitesSectionRuntime.js`
+Exports
+- `useAccountSettingsInvitesSectionRuntime()`
+Local functions
+- `normalizePendingInvite(entry)`
+
+### `src/client/components/AccountSettingsInvitesSection.vue`
+Exports
+- None
+
+### `src/client/components/MembersAdminClientElement.vue`
+Exports
+- None
+Local functions
+- `formatDateTime(value)`
+- `showOwnerChip(member)`
+- `isMemberRoleLocked(member)`
+- `isMemberRemoveLocked(member)`
+- `isRevokeInviteLoading(inviteId)`
+- `isRemoveMemberLoading(memberUserId)`
+- `onSubmitInvite()`
+- `onRevokeInvite(inviteId)`
+- `onMemberRoleUpdate(member, roleSid)`
+- `onRemoveMember(member)`
+
+### `src/client/components/UsersProfileSurfaceSwitchMenuItem.vue`
+Exports
+- None
+
+### `src/client/components/UsersWorkspaceMembersMenuItem.vue`
+Exports
+- None
+
+### `src/client/components/UsersWorkspacePermissionMenuItem.vue`
+Exports
+- None
+Local functions
+- `normalizeRequiredPermissions(value)`
+
+### `src/client/components/UsersWorkspaceSelector.vue`
+Exports
+- None
+Local functions
+- `resolveBrowserPath()`
+- `navigateToWorkspace(slug)`
+- `workspaceAvatarStyle(workspace)`
+
+### `src/client/components/UsersWorkspaceSettingsMenuItem.vue`
+Exports
+- None
+
+### `src/client/components/UsersWorkspaceToolsWidget.vue`
+Exports
+- None
+
+### `src/client/components/WorkspaceMembersClientElement.vue`
+Exports
+- None
+Local functions
+- `workspaceMembersPath(memberId)`
+- `workspaceInvitePath(inviteId)`
+- `resetMessages()`
+- `clearRoleOptions()`
+- `resetViewState()`
+- `toRoleTitle(roleSid)`
+- `normalizeRoleCatalog(payload = {})`
+- `applyRoleCatalog(payload = {})`
+- `normalizeMembers(entries)`
+- `normalizeInvites(entries)`
+- `latestPage(pages)`
+- `applyWorkspaceSettingsPolicy(payload = {})`
+- `submitInvite()`
+- `submitRevokeInvite(inviteId)`
+- `submitMemberRoleUpdate(member, roleSid)`
+- `submitRemoveMember(member)`
+
+### `src/client/components/WorkspaceProfileClientElement.vue`
+Exports
+- None
+
+### `src/client/components/WorkspacesClientElement.vue`
+Exports
+- None
+Local functions
+- `normalizePendingInvite(entry)`
+- `reportFeedback({ message, severity = "error", channel = "banner", dedupeKey = "" } = {})`
+- `workspaceInitials(workspace)`
+- `workspaceAvatarStyle(workspace)`
+- `workspaceHomePath(workspaceSlug)`
+- `openWorkspace(workspaceSlug)`
+- `respondToInvite(invite, decision)`
+- `acceptInvite(invite)`
+- `refuseInvite(invite)`
+- `createWorkspace()`
+
+### `src/client/components/WorkspaceSettingsClientElement.vue`
+Exports
+- None
+Local functions
+- `toWorkspaceEntrySnapshot(entry = null)`
+- `toWorkspaceListSnapshot(list = [])`
+- `toWorkspaceSettingsSnapshot(settings = null)`
+- `applyShellWorkspaceContext(payload = {})`
+- `handleFormSaved()`
+
+### `src/client/components/WorkspaceSettingsFieldsClientElement.vue`
+Exports
+- None
+
+### `src/client/composables/useBootstrapQuery.js`
+Exports
+- `useBootstrapQuery({ workspaceSlug = "", enabled = true, staleTime = DEFAULT_BOOTSTRAP_STALE_TIME_MS, refetchOnMount = false, refetchOnWindowFocus = false } = {})`
+Local functions
+- `normalizeStaleTime(value, fallback = DEFAULT_BOOTSTRAP_STALE_TIME_MS)`
+
+### `src/client/composables/useWorkspaceRouteContext.js`
+Exports
+- `useWorkspaceRouteContext()`
+
+### `src/client/composables/useWorkspaceSurfaceId.js`
+Exports
+- `useWorkspaceSurfaceId({ route = null, placementContext = null } = {})`
+Local functions
+- `resolveCurrentPathname(route = null)`
+
+### `src/client/index.js`
+Exports
+- `WorkspacesWebClientProvider`
+- `WorkspaceMembersClientElement`
+- `clientProviders`
+
+### `src/client/lib/bootstrap.js`
+Exports
+- `buildBootstrapApiPath(workspaceSlug = "")`
+- `findWorkspaceBySlug(entries = [], workspaceSlug = "")`
+- `normalizeWorkspaceEntry(entry = null)`
+- `normalizeWorkspaceList(entries = [])`
+Local functions
+- `normalizeWorkspaceSlug(value = "")`
+
+### `src/client/lib/httpClient.js`
+Exports
+- `workspacesWebHttpClient`
+
+### `src/client/lib/permissions.js`
+Exports
+- `normalizePermissionList`
+- `arePermissionListsEqual(left, right)`
+- `hasPermission`
+Local functions
+- `toPermissionSet(values)`
+
+### `src/client/lib/profileSurfaceMenuLinks.js`
+Exports
+- `resolveProfileSurfaceMenuLinks({ context, surface } = {})`
+- `resolvePrimarySurfaceSwitchLink({ context, surface } = {})`
+- `resolveSurfaceSwitchLinks({ context, surface } = {})`
+- `hasWorkspaceMembership`
+Local functions
+- `resolveSurfaceSwitchIcon(surfaceId = "", explicitIcon = "")`
+- `resolveCurrentWorkspaceSlug(contextValue, surfaceId)`
+- `shouldIncludeSurfaceSwitchTarget(surfaceDefinition = null)`
+- `resolveSurfaceSwitchLinkLabel(surfaceDefinition = null, surfaceId = "")`
+
+### `src/client/lib/surfaceAccessPolicy.js`
+Exports
+- `hasWorkspaceMembership(contextValue = null, workspaceSlug = "")`
+- `resolveSurfaceAccessPolicy(contextValue = null, surfaceDefinition = null)`
+- `evaluateSurfaceAccess({ context = null, surfaceId = "", workspaceSlug = "", allowOnUnknown = false } = {})`
+Local functions
+- `normalizeSurfaceAccessPolicyId(value = "")`
+- `normalizeWorkspaceSlug(value = "")`
+- `normalizeAccessFlagName(value = "")`
+- `normalizeStringList(value)`
+- `normalizeSurfaceAccessFlags(value = null)`
+- `hasPlacementValue(source, key)`
+- `hasKnownWorkspaceMembershipContext(contextValue = null)`
+- `hasKnownPermissionsContext(contextValue = null)`
+- `hasKnownSurfaceAccessContext(contextValue = null)`
+- `resolveSurfaceAccessPolicies(contextValue = null)`
+- `toAccessDecision({ allowed = false, pending = false, reason = "" } = {})`
+- `evaluatePermissionRequirements(policy, permissions = [])`
+- `evaluateFlagRequirements(policy, flags = {})`
+
+### `src/client/lib/theme.js`
+Exports
+- `hexColorToRgb(value = "")`
+- `normalizeThemePreference(value)`
+- `persistBootstrapThemePreference(payload = {}, options = {})`
+- `persistThemePreference(themePreference, options = {})`
+- `readPersistedThemePreference(options = {})`
+- `resolveBootstrapThemePreference(payload = {}, options = {})`
+- `resolveThemeNameForPreference(themePreference, options = {})`
+- `resolveBootstrapThemeName(payload = {}, options = {})`
+- `resolveVuetifyThemeController(vueApp)`
+- `setVuetifyPrimaryColorOverride(themeController, themeInput = null)`
+- `setVuetifyThemeName(themeController, themeName)`
+Local functions
+- `resolveSystemThemeName({ prefersDark } = {})`
+- `resolveThemePreferenceStorage(options = {})`
+- `normalizeHexColor(value = "")`
+- `resolveVuetifyThemeDefinitions(themeController)`
+- `normalizeThemeColors(colors)`
+- `normalizeWorkspaceBaseThemeName(themeName = "")`
+- `areThemeColorsEqual(leftColors = {}, rightColors = {})`
+- `composeWorkspaceThemeDefinition(baseThemeDefinition, palette)`
+- `upsertThemeDefinition(themeDefinitions, themeName, nextDefinition)`
+
+### `src/client/lib/workspaceLinkResolver.js`
+Exports
+- `resolveWorkspaceSlugFromContextOrPath({ context = null, surface = "", workspaceSlug = "", pathname = "" } = {})`
+- `resolveWorkspaceShellLinkPath({ context = null, surface = "", mode = "auto", explicitTo = "", relativePath = "/", workspaceRelativePath = "", surfaceRelativePath = "", workspaceSlug = "", pathname = "" } = {})`
+- `useWorkspaceLinkResolver({ surface = "", workspaceSlug = "", pathname = "" } = {})`
+Local functions
+- `resolveSurfaceBasePath(context = null, surface = "")`
+- `resolveWorkspaceBasePath(context = null, surface = "", workspaceSlug = "")`
+
+### `src/client/lib/workspaceSurfaceContext.js`
+Exports
+- `listWorkspaceSurfaceIdsFromSurfaceConfig(surfaceConfig = null)`
+- `surfaceRequiresWorkspaceFromPlacementContext(contextValue = null, surfaceId = "")`
+- `resolveSurfaceSwitchTargetsFromPlacementContext(contextValue = null, surfaceId = "")`
+Local functions
+- `listNonWorkspaceSurfaceIdsFromSurfaceConfig(surfaceConfig = null)`
+- `listSurfaceIdsFromSurfaceConfig(surfaceConfig = null, { requiresWorkspace = null } = {})`
+- `firstAlternativeSurfaceId(surfaceIds = [], excludeSurfaceId = "")`
+
+### `src/client/lib/workspaceSurfacePaths.js`
+Exports
+- `resolveAccountSettingsPathFromPlacementContext(contextValue = null)`
+- `resolveWorkspaceSurfaceIdFromPlacementPathname(contextValue = null, pathname = "")`
+- `resolveSurfaceWorkspacePathFromPlacementContext(contextValue = null, surfaceId = "", workspaceSlug = "", suffix = "/")`
+- `extractWorkspaceSlugFromSurfacePathname(contextValue = null, surfaceId = "", pathname = "")`
+Local functions
+- `normalizeWorkspaceSuffix(suffix)`
+- `resolveWorkspaceSurfaceIdFromSurfaceConfig(surfaceConfig, pathname = "")`
+
+### `src/client/providers/WorkspacesWebClientProvider.js`
+Exports
+- `WorkspacesWebClientProvider`
+
+### `src/client/runtime/bootstrapPlacementRouteGuards.js`
+Exports
+- `createBootstrapPlacementRouteGuards({ placementRuntime, router = null, root = null, getWorkspaceBootstrapStatus = () => "" } = {})`
+
+### `src/client/runtime/bootstrapPlacementRuntime.js`
+Exports
+- `WORKSPACE_BOOTSTRAP_STATUS_RESOLVED`
+- `WORKSPACE_BOOTSTRAP_STATUS_NOT_FOUND`
+- `WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN`
+- `WORKSPACE_BOOTSTRAP_STATUS_UNAUTHENTICATED`
+- `WORKSPACE_BOOTSTRAP_STATUS_ERROR`
+- `createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap = fetchBootstrapPayload } = {})`
+
+### `src/client/runtime/bootstrapPlacementRuntimeConstants.js`
+Exports
+- `SHELL_GUARD_EVALUATOR_KEY`
+- `WORKSPACE_BOOTSTRAP_STATUSES`
+- `WORKSPACE_BOOTSTRAP_STATUS_ERROR`
+- `WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN`
+- `WORKSPACE_BOOTSTRAP_STATUS_NOT_FOUND`
+- `WORKSPACE_BOOTSTRAP_STATUS_RESOLVED`
+- `WORKSPACE_BOOTSTRAP_STATUS_UNAUTHENTICATED`
+- `WORKSPACE_FORBIDDEN_GUARD_REASON`
+- `WORKSPACE_NOT_FOUND_GUARD_REASON`
+
+### `src/client/runtime/bootstrapPlacementRuntimeHelpers.js`
+Exports
+- `countPendingInvites(entries = [])`
+- `createProviderLogger(app)`
+- `fetchBootstrapPayload(workspaceSlug = "")`
+- `isGuardDenied(outcome)`
+- `normalizeSearch(search = "")`
+- `normalizeWorkspaceBootstrapStatus(status = "")`
+- `normalizeWorkspaceSlugKey(workspaceSlug = "")`
+- `resolveAuthSignature(context = {})`
+- `resolveRequestedWorkspaceBootstrapStatus(payload = {}, workspaceSlug = "")`
+- `resolveRouteState(placementRuntime, router)`
+- `resolveSearchFromFullPath(fullPath = "")`
+
+### `src/client/support/realtimeWorkspace.js`
+Exports
+- `matchesCurrentWorkspaceEvent(payload = {}, workspaceSlug = "")`
+- `createWorkspaceRealtimeMatcher(workspaceSlugRef)`
+
+### `src/client/support/runtimeNormalization.js`
+Exports
+- `normalizeRecord(value)`
+- `normalizeWorkspaceBootstrapStatusValue(status = "", allowedStatuses = null)`
+- `resolveErrorStatusCode(error)`
+
+### `src/client/support/workspaceQueryKeys.js`
+Exports
+- `buildWorkspaceQueryKey(kind = "", surfaceId = "", workspaceSlug = "")`
+
+### `src/shared/toolsOutletContracts.js`
+Exports
+- `DEFAULT_TOOLS_LINK_COMPONENT_TOKEN`
+- `WORKSPACE_TOOLS_OUTLET`
+
+### templates
+
+### `templates/packages/main/src/client/components/AccountPendingInvitesCue.vue`
+Exports
+- None
+Local functions
+- `normalizePendingInvitesCount(value)`
+- `resolveReturnTo()`
+- `resolveReturnToHref()`
+- `countPendingInvites(entries = [])`
+
+### `templates/src/components/WorkspaceNotFoundCard.vue`
+Exports
+- None
+
+### `templates/src/composables/useWorkspaceNotFoundState.js`
+Exports
+- `useWorkspaceNotFoundState()`
+
+### `templates/src/pages/admin/members/index.vue`
+Exports
+- None
+
+### `templates/src/pages/admin/workspace/settings.vue`
+Exports
+- None
+
+### `templates/src/pages/admin/workspace/settings/index.vue`
+Exports
+- None
+
+### `templates/src/surfaces/admin/index.vue`
+Exports
+- None
+
+### `templates/src/surfaces/admin/root.vue`
+Exports
+- None
+
+### `templates/src/surfaces/app/index.vue`
+Exports
+- None
+
+### `templates/src/surfaces/app/root.vue`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/tooling/config-eslint.md

@@ -0,0 +1,52 @@
+# tooling/config-eslint
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/config-eslint`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/config-eslint/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/client/index.js`
+Exports
+- None
+
+### `src/index.js`
+Exports
+- None
+
+### `src/server/index.js`
+Exports
+- None
+
+### root
+
+### `base.js`
+Exports
+- `baseConfig`
+
+### `index.js`
+Exports
+- `baseConfig`
+- `nodeConfig`
+- `webConfig`
+- `vueConfig`
+
+### `node.js`
+Exports
+- `nodeConfig`
+
+### `vue.js`
+Exports
+- `vueConfig`
+
+### `web.js`
+Exports
+- `webConfig`

package/reference/autogen/tooling/create-app.md

@@ -0,0 +1,194 @@
+# tooling/create-app
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/create-app`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/create-app/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### src
+
+### `src/client/index.js`
+Exports
+- None
+
+### `src/index.js`
+Exports
+- None
+
+### `src/server/cliEntrypoint.js`
+Exports
+- `shellQuote(value)`
+- `runCliEntrypoint(runCli, argv = process.argv.slice(2))`
+
+### `src/server/cliError.js`
+Exports
+- `createCliError(message, { showUsage = false, exitCode = 1 } = {})`
+
+### `src/server/index.js`
+Exports
+- `createApp({ appName, appTitle = null, template = DEFAULT_TEMPLATE, target = null, initialBundles = DEFAULT_INITIAL_BUNDLES, tenancyMode = null, force = false, dryRun = false, cwd = process.cwd() })`
+- `runCli(argv, { stdout = process.stdout, stderr = process.stderr, stdin = process.stdin, cwd = process.cwd(), readlineFactory = createReadlineInterface } = {})`
+Local functions
+- `toAppTitle(appName)`
+- `normalizeInitialBundlesPreset(value, { showUsage = true } = {})`
+- `normalizeTenancyMode(value, { showUsage = true } = {})`
+- `buildInitialSetupCommands(initialBundles)`
+- `validateAppName(appName, { showUsage = true } = {})`
+- `parseOptionWithValue(argv, index, optionName)`
+- `parseCliArgs(argv)`
+- `printUsage(stream = process.stderr)`
+- `applyPlaceholders(source, replacements)`
+- `isPathWithinRoot(rootPath, candidatePath)`
+- `normalizeTemplatePathSegments(templateName)`
+- `resolveTemplateDirectory(templateName)`
+- `ensureTargetDirectoryState(targetDirectory, { force = false, dryRun = false } = {})`
+- `sortEntriesByName(entries)`
+- `mapTemplatePathToTargetPath(relativePath)`
+- `writeTemplateFile(sourcePath, targetPath, replacements)`
+- `copyTemplateDirectory({ templateDirectory, targetDirectory, replacements, dryRun })`
+- `toRelativeTargetLabel(cwd, targetDirectory)`
+- `askQuestion(readline, label, defaultValue)`
+- `askYesNoQuestion(readline, label, defaultValue)`
+- `createReadlineInterface({ stdin = process.stdin, stdout = process.stdout } = {})`
+- `collectInteractiveOptions({ parsed, stdout = process.stdout, stderr = process.stderr, stdin = process.stdin, readlineFactory = createReadlineInterface })`
+
+### templates
+
+### `templates/base-shell/bin/server.js`
+Exports
+- None
+
+### `templates/base-shell/config/public.js`
+Exports
+- `config`
+
+### `templates/base-shell/config/server.js`
+Exports
+- `config`
+
+### `templates/base-shell/config/surfaceAccessPolicies.js`
+Exports
+- `surfaceAccessPolicies`
+
+### `templates/base-shell/eslint.config.mjs`
+Exports
+- None
+
+### `templates/base-shell/packages/main/package.descriptor.mjs`
+Exports
+- None
+
+### `templates/base-shell/packages/main/src/client/index.js`
+Exports
+- `MainClientProvider`
+- `registerMainClientComponent`
+
+### `templates/base-shell/packages/main/src/client/providers/MainClientProvider.js`
+Exports
+- `MainClientProvider`
+- `registerMainClientComponent(token, resolveComponent)`
+
+### `templates/base-shell/packages/main/src/server/controllers/index.js`
+Exports
+- None
+
+### `templates/base-shell/packages/main/src/server/index.js`
+Exports
+- `MainServiceProvider`
+
+### `templates/base-shell/packages/main/src/server/providers/MainServiceProvider.js`
+Exports
+- `MainServiceProvider`
+
+### `templates/base-shell/packages/main/src/server/routes/index.js`
+Exports
+- None
+
+### `templates/base-shell/packages/main/src/server/services/index.js`
+Exports
+- None
+
+### `templates/base-shell/packages/main/src/server/support/loadAppConfig.js`
+Exports
+- `loadAppConfig({ moduleUrl = import.meta.url } = {})`
+
+### `templates/base-shell/packages/main/src/shared/index.js`
+Exports
+- None
+
+### `templates/base-shell/packages/main/src/shared/schemas/index.js`
+Exports
+- None
+
+### `templates/base-shell/server.js`
+Exports
+- `createServer()`
+- `startServer(options = {})`
+Local functions
+- `toRequestPathname(urlValue)`
+- `isApiPath(pathname)`
+- `hasFileExtension(pathname)`
+- `resolveGlobalUiPaths(runtimeGlobalUiPaths = [])`
+- `resolveStaticFilePath(pathname)`
+- `canServeStaticFile(distRoot, relativePath)`
+
+### `templates/base-shell/server/lib/runtimeEnv.js`
+Exports
+- `resolveRuntimeEnv()`
+Local functions
+- `toPort(value, fallback = 3000)`
+- `ensureRuntimeEnvLoaded()`
+
+### `templates/base-shell/server/lib/surfaceRuntime.js`
+Exports
+- `surfaceRuntime`
+
+### `templates/base-shell/src/App.vue`
+Exports
+- None
+
+### `templates/base-shell/src/main.js`
+Exports
+- None
+
+### `templates/base-shell/src/pages/home.vue`
+Exports
+- None
+
+### `templates/base-shell/src/pages/home/index.vue`
+Exports
+- None
+
+### `templates/base-shell/src/views/NotFound.vue`
+Exports
+- None
+
+### `templates/base-shell/vite.config.mjs`
+Exports
+- None
+Local functions
+- `clientEntry(()`
+
+### `templates/base-shell/vite.shared.mjs`
+Exports
+- `toPositiveInt(value, fallback)`
+- `loadViteDevProxyEntries({ appRootUrl = import.meta.url, fallbackTarget = "" } = {})`
+
+### bin
+
+### `bin/jskit-create-app.js`
+Exports
+- None
+
+### root
+
+### `package.descriptor.mjs`
+Exports
+- None

package/reference/autogen/tooling/jskit-catalog.md

@@ -0,0 +1,27 @@
+# tooling/jskit-catalog
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/jskit-catalog`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/jskit-catalog/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### scripts
+
+### `scripts/build-catalog.mjs`
+Exports
+- None
+Local functions
+- `parseInlineArg(name)`
+- `toSortedUniqueStrings(values)`
+- `fileExists(absolutePath)`
+- `collectPackageRoots(packagesRoot)`
+- `readJson(absolutePath)`
+- `buildCatalog({ repoRoot, packagesRoot, outputPath })`
+- `main()`