@jskit-ai/agent-docs 0.1.1

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

@@ -0,0 +1,624 @@
+# tooling/jskit-cli
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/jskit-cli`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/jskit-cli/**/*{.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
+- `runCliEntrypoint(runCli, argv = process.argv.slice(2))`
+
+### `src/server/cliRuntime/appState.js`
+Exports
+- `resolveAppRootFromCwd(cwd)`
+- `loadAppPackageJson(appRoot)`
+- `createDefaultLock()`
+- `loadLockFile(appRoot)`
+- `createManagedPackageJsonChange(hadPrevious, previousValue, value)`
+- `ensurePackageJsonSection(packageJson, sectionName)`
+- `applyPackageJsonField(packageJson, sectionName, key, value)`
+- `removePackageJsonField(packageJson, sectionName, key)`
+- `restorePackageJsonField(packageJson, sectionName, key, managedChange)`
+- `parseEnvLineValue(line, key)`
+- `upsertEnvValue(content, key, value)`
+- `removeEnvValue(content, key, expectedValue, previous)`
+- `writeJsonFile`
+
+### `src/server/cliRuntime/capabilitySupport.js`
+Exports
+- `listDeclaredCapabilities(capabilitiesSection, fieldName)`
+- `buildCapabilityDetailsForPackage({ packageRegistry, packageId, dependsOn = [], provides = [], requires = [] })`
+- `validatePlannedCapabilityClosure(plannedPackageIds, packageRegistry, actionLabel)`
+Local functions
+- `buildCapabilityGraph(packageRegistry)`
+- `createCapabilityPackageDetail(packageId, packageRegistry)`
+- `collectPlannedCapabilityIssues(plannedPackageIds, packageRegistry)`
+
+### `src/server/cliRuntime/completion.js`
+Exports
+- `discoverPlacementTargets(appRoot)`
+- `discoverResourceDisplayFields(appRoot, resourceFile = "")`
+- `discoverResourceFiles(appRoot)`
+- `discoverSurfaces(appRoot)`
+- `getCompletions({ appRoot = process.cwd(), words = [], cword = 0 } = {})`
+- `normalizeCompletionInvocation(words = [], cword = 0)`
+- `renderBashCompletionScript()`
+Local functions
+- `normalizeText(value = "")`
+- `toPosix(value = "")`
+- `uniqueSorted(values = [])`
+- `filterByPrefix(values = [], prefix = "")`
+- `resolveAllowedValues(schema = {})`
+- `ensureTrailingSlash(value = "")`
+- `pathExists(targetPath)`
+- `readJsonFile(filePath)`
+- `safeReaddir(directoryPath)`
+- `walkDirectory(rootPath, { includeDirectories = false, includeFiles = true, fileFilter = null } = {})`
+- `importDefaultModule(modulePath)`
+- `loadCommandCatalog()`
+- `isDirectoryLike(entry)`
+- `discoverDescriptorPackages(appRoot)`
+- `discoverBundleIds(appRoot)`
+- `toShortPackageId(packageId = "")`
+- `discoverGenerators(appRoot)`
+- `discoverRuntimePackages(appRoot)`
+- `extractMatches(source = "", patterns = [])`
+- `discoverComponentTokens(appRoot)`
+- `isRouteLikeRelativePath(relativePath = "")`
+- `discoverPagesRelativeDirectories(appRoot)`
+- `discoverPagesRelativeFiles(appRoot)`
+- `discoverAppVueFiles(appRoot)`
+- `buildOptionSuggestions(optionNames = [], { current = "", seenOptionNames = new Set() } = {})`
+- `parseOptionToken(token = "")`
+- `parseContextTokens(tokens = [], optionMeta = {})`
+- `resolveCurrentOptionValueRequest({ currentToken = "", previousToken = "", optionMeta = {} } = {})`
+- `completeCommaSeparatedValues({ currentValue = "", allowedValues = [] } = {})`
+- `extractBracketParams(value = "")`
+- `completeOptionValue({ appRoot, optionName = "", valuePrefix = "", includeOptionPrefix = false, parseState, currentGenerator = "", optionMeta = {} } = {})`
+- `completeRelativeDirectoryRoot(appRoot, current = "")`
+- `completeRelativePageTargetFile(appRoot, current = "")`
+- `completeAppVueFile(appRoot, current = "")`
+- `buildTopLevelCommandMetadata(catalogModule)`
+- `buildCommandOptionMeta(command = "", catalogModule)`
+- `buildGeneratorLookup(generators = [])`
+- `buildGeneratorOptionMeta(generator = null, subcommandName = "")`
+- `resolveImplicitGeneratorSubcommand(generator = null, tokensAfterGenerator = [], currentToken = "")`
+- `completeGenericContext({ appRoot, currentToken = "", previousToken = "", optionMeta = {}, positionalArgs = [], tokensBeforeCurrent = [], optionNames = [], positionalCompleter = null, generatorName = "", subcommandName = "" } = {})`
+- `completeTopLevel({ currentToken = "", catalogModule })`
+- `completeGenerateCommand({ appRoot, words, cword, catalogModule })`
+- `completeCommand({ appRoot, words, cword, catalogModule })`
+
+### `src/server/cliRuntime/descriptorValidation.js`
+Exports
+- `validatePackageDescriptorShape(descriptor, descriptorPath)`
+- `validateAppLocalPackageDescriptorShape(descriptor, descriptorPath, { expectedPackageId = "", fallbackVersion = "" } = {})`
+- `createPackageEntry({ packageId, version, descriptor, rootDir = "", relativeDir = "", descriptorRelativePath = "", packageJson = {}, sourceType = "", source = {} })`
+- `isGeneratorPackageEntry(packageEntry)`
+Local functions
+- `normalizePackageKind(rawValue, descriptorPath)`
+- `validateFileMutationShape(descriptor, descriptorPath)`
+
+### `src/server/cliRuntime/ioAndMigrations.js`
+Exports
+- `buildFileWriteGroups(fileMutations, { packageId = "" } = {})`
+- `normalizeRelativePath(fromRoot, absolutePath)`
+- `hashBuffer(buffer)`
+- `normalizeMigrationExtension(value = "", fallback = ".cjs")`
+- `normalizeMigrationId(value, packageId)`
+- `resolveAppRelativePathWithinRoot(appRoot, relativePath, contextLabel = "path")`
+- `normalizeMigrationDirectory(value, packageId)`
+- `formatMigrationTimestamp(date = new Date())`
+- `buildManagedMigrationFileName({ packageId = "", migrationId = "", extension = ".cjs", timestamp = "" } = {})`
+- `buildManagedMigrationRelativePath({ toDir = "migrations", packageId = "", migrationId = "", extension = ".cjs", timestamp = "" } = {})`
+- `buildManagedMigrationRelativePathLabel({ toDir = "migrations", migrationId = "", extension = ".cjs" } = {})`
+- `findExistingManagedMigrationPathById({ appRoot, toDir = "migrations", packageId = "", migrationId = "", extension = ".cjs" } = {})`
+- `upsertManagedMigrationRecord(managedMigrations, record)`
+- `fileExists(absolutePath)`
+- `readJsonFile(absolutePath)`
+- `writeJsonFile(absolutePath, value)`
+- `readFileBufferIfExists(absolutePath)`
+- `loadAppConfigModuleConfig(appRoot, relativePath)`
+- `loadMutationWhenConfigContext(appRoot)`
+Local functions
+- `normalizeRelativePosixPath(pathValue)`
+
+### `src/server/cliRuntime/localPackageSupport.js`
+Exports
+- `resolvePackageDependencySpecifier(packageEntry, { existingValue = "" } = {})`
+- `normalizeJskitDependencySpecifier(packageId, dependencySpecifier)`
+- `normalizePackageNameSegment(rawValue, { label = "package name" } = {})`
+- `normalizeScopeName(rawScope)`
+- `resolveDefaultLocalScopeFromAppName(appPackageName)`
+- `normalizeRelativePosixPath(pathValue)`
+- `toFileDependencySpecifier(relativePath)`
+- `resolveLocalPackageId({ rawName, appPackageName, inlineOptions })`
+- `createLocalPackageScaffoldFiles({ packageId, packageDescription })`
+- `resolveLocalDependencyOrder(initialPackageIds, packageRegistry)`
+Local functions
+- `createLocalPackageDescriptorTemplate({ packageId, description })`
+
+### `src/server/cliRuntime/mutationApplication.js`
+Exports
+- `applyFileMutations`
+- `prepareFileMutations`
+- `applyTextMutations`
+- `partitionPreFileConfigTextMutations`
+- `resolvePositioningMutations`
+
+### `src/server/cliRuntime/mutations/fileMutations.js`
+Exports
+- `applyFileMutations(packageEntry, appRoot, preparedMutations, managedFiles, managedMigrations, touchedFiles, warnings = [], existingManagedFiles = [])`
+- `prepareFileMutations(packageEntry, options, appRoot, fileMutations, existingManagedFiles = [])`
+
+### `src/server/cliRuntime/mutations/installMigrationMutation.js`
+Exports
+- `applyInstallMigrationMutation({ packageEntry, preparedMutation, appRoot, managedMigrations, managedMigrationById, touchedFiles, warnings } = {})`
+
+### `src/server/cliRuntime/mutations/mutationPathUtils.js`
+Exports
+- `normalizeMutationRelativeFilePath(value = "")`
+
+### `src/server/cliRuntime/mutations/surfaceTargets.js`
+Exports
+- `resolveSurfaceTargetPathsForMutation({ appRoot, packageId, mutation, configContext } = {})`
+Local functions
+- `normalizeSurfacePagesRootForMutation(value = "")`
+- `normalizeSurfacePathForMutation(value = "", { context = "toSurfacePath" } = {})`
+- `resolveSurfaceDefinitionFromConfigForMutation({ configContext = {}, surfaceId = "", packageId = "" } = {})`
+
+### `src/server/cliRuntime/mutations/templateContext.js`
+Exports
+- `applyTemplateContextReplacements(sourceContent, replacements)`
+- `interpolateFileMutationRecord(mutation, options, packageId)`
+- `renderTemplateFile(sourcePath, options, packageId, interpolationKey, templateContextReplacements = null)`
+- `resolveTemplateContextReplacementsForMutation({ packageEntry, mutation, options, appRoot, sourcePath, targetPaths, mutationContext = "files mutation" } = {})`
+
+### `src/server/cliRuntime/mutations/textMutations.js`
+Exports
+- `applyTextMutations(packageEntry, appRoot, textMutations, options, managedText, touchedFiles)`
+- `partitionPreFileConfigTextMutations(textMutations = [])`
+- `resolvePositioningMutations(descriptorMutations = {})`
+Local functions
+- `resolveSettingsFieldsContractTarget(relativeFile = "")`
+- `validateSettingsFieldsContractMutationTarget({ appRoot, relativeFile, packageId } = {})`
+- `isPositioningTextMutation(value = {})`
+- `isPreFileConfigTextMutation(value = {})`
+
+### `src/server/cliRuntime/mutationWhen.js`
+Exports
+- `normalizeMutationExtension(value)`
+- `normalizeTemplateContextRecord(value)`
+- `normalizeFileMutationRecord(value)`
+- `normalizeMutationWhen(value)`
+- `readObjectPath(source, rawPath)`
+- `normalizeWhenSourceValue(value)`
+- `resolveWhenConfigValue(configContext = {}, configPath = "")`
+- `shouldApplyMutationWhen(when, { options = {}, configContext = {}, packageId = "", mutationContext = "mutation" } = {})`
+Local functions
+- `normalizeWhenComparisonValue(value)`
+- `splitWhenComparisonTokens(value)`
+- `matchesWhenComparisonValue(optionValue, optionTokens, expectedValue)`
+
+### `src/server/cliRuntime/packageInstallFlow.js`
+Exports
+- `adoptAppLocalPackageDependencies({ appRoot, appPackageJson, lock })`
+- `applyPackageInstall({ packageEntry, packageOptions, appRoot, appPackageJson, lock, packageRegistry, touchedFiles, reportTemplateFetchStatus = null })`
+- `applyPackageMigrationsOnly({ packageEntry, packageOptions, appRoot, lock, touchedFiles })`
+- `applyPackagePositioning({ packageEntry, packageOptions, appRoot, lock, touchedFiles })`
+Local functions
+- `createManagedRecordBase(packageEntry, options)`
+- `cloneManagedMap(value = {})`
+- `cloneManagedArray(value = [])`
+- `resolveManagedSourceRecord(packageEntry, existingInstall = {})`
+
+### `src/server/cliRuntime/packageIntrospection.js`
+Exports
+- `classifyExportedSymbols`
+- `deriveProviderDisplayName`
+- `formatPackageSubpathImport`
+- `inspectPackageOfferings({ packageEntry })`
+- `normalizePlacementContributions`
+- `normalizePlacementOutlets`
+- `shouldShowPackageExportTarget`
+
+### `src/server/cliRuntime/packageIntrospection/exportedSymbols.js`
+Exports
+- `classifyExportedSymbols(symbols = [])`
+- `collectExportFileSymbolSummaries({ packageRoot, packageExports, notes })`
+Local functions
+- `parseNamedExportSpecifiers(specifierSource)`
+- `parseExportedSymbolsFromSource(source)`
+
+### `src/server/cliRuntime/packageIntrospection/exportEntries.js`
+Exports
+- `describePackageExports({ packageRoot, packageJson })`
+- `formatPackageSubpathImport(packageId, subpath)`
+- `shouldShowPackageExportTarget({ subpath, target, targetType })`
+Local functions
+- `collectPackageExportEntries(exportsField)`
+- `deriveCanonicalExportTargetForSubpath(subpath)`
+
+### `src/server/cliRuntime/packageIntrospection/placementNormalization.js`
+Exports
+- `normalizePlacementContributions(value)`
+- `normalizePlacementOutlets(value)`
+
+### `src/server/cliRuntime/packageIntrospection/providerBindingIntrospection.js`
+Exports
+- `collectContainerBindingsFromProviderSource({ source, providerLabel, entrypoint, providerExportName })`
+- `deriveProviderDisplayName(bindingRecord)`
+Local functions
+- `escapeRegexLiteral(value)`
+- `parseQuotedStringLiteral(value)`
+- `resolveLineNumberAtIndex(source, index)`
+- `findMatchingBraceIndex(source, openBraceIndex)`
+- `extractProviderLifecycleMethodRanges(source, providerExportName)`
+- `collectConstTokenAssignments(source)`
+- `resolveTokenFromExpression(expression, constAssignments, visited = new Set())`
+
+### `src/server/cliRuntime/packageOptions.js`
+Exports
+- `normalizeSurfaceIdForMutation(value = "")`
+- `parseSurfaceIdListForMutation(value = "")`
+- `resolvePackageOptions(packageEntry, inlineOptions, io, { appRoot = "" } = {})`
+- `validateInlineOptionsForPackage(packageEntry, inlineOptions)`
+- `validateInlineOptionValuesForPackage(packageEntry, inlineOptions, { appRoot = "", optionNames = null } = {})`
+Local functions
+- `resolveSurfaceVisibilityOptionPolicy(packageEntry = {})`
+- `resolveSurfaceDefinitionsForOptionPolicy(configContext = {})`
+- `normalizeResolvedOptionValue(value = "")`
+- `normalizeResolvedOptionSchemaValue({ packageEntry, optionName = "", schema = {}, value = "" } = {})`
+- `resolveSchemaValidatedOptionNames(packageEntry = {}, validationType = "", { optionNames = null } = {})`
+- `resolveAllowedValuesForSchema(schema = {})`
+- `parseCsvEnumOptionValues(value = "")`
+- `validateEnumOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null } = {})`
+- `validateCsvEnumOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null } = {})`
+- `validateEnabledSurfaceOptionValues({ packageEntry, resolvedOptions = {}, optionNames = null, configContext = {} } = {})`
+- `validateSurfaceVisibilityOptionPolicy({ packageEntry, resolvedOptions = {}, policy, configContext = {} } = {})`
+- `validateResolvedOptionPolicies({ packageEntry, resolvedOptions = {}, appRoot = "", resolveConfigContext } = {})`
+- `resolvePromptChoicesForOption({ schema = {}, configContext = {} } = {})`
+- `validateOptionValuesForPackage({ packageEntry, resolvedOptions = {}, appRoot = "", optionNames = null } = {})`
+
+### `src/server/cliRuntime/packageRegistries.js`
+Exports
+- `isGeneratorPackageEntry`
+- `mergePackageRegistries(...registries)`
+- `loadAppLocalPackageRegistry(appRoot)`
+- `loadPackageRegistry()`
+- `resolveInstalledNodeModulePackageEntry({ appRoot, packageId })`
+- `hydratePackageRegistryFromInstalledNodeModules({ appRoot, packageRegistry, seedPackageIds = [] })`
+- `loadBundleRegistry()`
+Local functions
+- `normalizeRelativePosixPath(pathValue)`
+- `validateBundleDescriptorShape(descriptor, descriptorPath)`
+- `loadCatalogPackageRegistry()`
+- `loadInstalledNodeModulePackageEntry({ appRoot, packageId })`
+
+### `src/server/cliRuntime/packageTemplateResolution.js`
+Exports
+- `cleanupMaterializedPackageRoots()`
+- `materializeCatalogPackageRoot({ packageEntry, appRoot, reportTemplateFetchStatus = null, installCatalogPackage = installCatalogPackageIntoCache } = {})`
+- `resolvePackageTemplateRoot({ packageEntry, appRoot, reportTemplateFetchStatus = null, materializeCatalogRoot = materializeCatalogPackageRoot } = {})`
+Local functions
+- `isInternalCatalogPackageEntry(packageEntry = {})`
+- `encodePackageCacheSegment(value = "")`
+- `buildMaterializedCacheKey(packageEntry = {})`
+- `buildMaterializedInstallRoot({ appRoot, packageEntry })`
+- `ensureMaterializedInstallWorkspace(installRoot)`
+- `installCatalogPackageIntoCache({ installRoot, packageEntry })`
+- `resolvePackageRootFromNodeModules({ appRoot, packageId })`
+- `loadLocalWorkspacePackageIdIndex()`
+- `resolvePackageRootFromLocalWorkspace({ packageId })`
+
+### `src/server/cliRuntime/viteProxy.js`
+Exports
+- `createEmptyViteDevProxyConfig()`
+- `normalizeViteDevProxyPath(value = "", { context = "vite proxy entry" } = {})`
+- `normalizeViteDevProxyEntry(value = {}, { context = "vite proxy entry" } = {})`
+- `normalizeViteDevProxyConfig(value = {}, { context = "vite proxy config" } = {})`
+- `resolveViteDevProxyConfigAbsolutePath(appRoot)`
+- `loadViteDevProxyConfig(appRoot, { context = "vite proxy config" } = {})`
+- `writeViteDevProxyConfig(appRoot, config = {}, touchedFiles = null)`
+- `normalizeViteProxyMutationRecord(value = {})`
+- `applyViteMutations(packageEntry, appRoot, viteMutations, options, managedVite, touchedFiles)`
+- `removeManagedViteProxyEntries({ appRoot, packageId, managedViteChanges = {}, touchedFiles = null } = {})`
+
+### `src/server/commandHandlers/completion.js`
+Exports
+- `createCompletionCommands(ctx = {})`
+Local functions
+- `resolveInstallBlock(relativeCompletionPath = "")`
+- `readTextFileIfExists(filePath = "")`
+- `installBashCompletion()`
+
+### `src/server/commandHandlers/health.js`
+Exports
+- `createHealthCommands(ctx = {})`
+
+### `src/server/commandHandlers/list.js`
+Exports
+- `createListCommands(ctx = {})`
+Local functions
+- `collectTokenMatches(source = "", pattern = COMPONENT_TOKEN_PATTERN)`
+- `appendTokenSource(map, token = "", source = "")`
+- `isLinkItemToken(token = "")`
+- `readFileIfExists(filePath = "")`
+- `resolveDescriptorFromLockEntry({ appRoot = "", packageId = "", installedPackageEntry = {} } = {})`
+- `collectProviderSourceFiles(rootPath = "")`
+
+### `src/server/commandHandlers/package.js`
+Exports
+- `createPackageCommands(ctx = {})`
+
+### `src/server/commandHandlers/packageCommands/add.js`
+Exports
+- `runPackageAddCommand(ctx = {}, { positional, options, cwd, io })`
+Local functions
+- `collectPlacementComponentTokensFromManagedRecords(installedPackageRecords = [])`
+
+### `src/server/commandHandlers/packageCommands/create.js`
+Exports
+- `runPackageCreateCommand(ctx = {}, { positional, options, cwd, io })`
+
+### `src/server/commandHandlers/packageCommands/discoverabilityHelp.js`
+Exports
+- `isHelpToken(value = "")`
+- `renderGenerateCatalogHelp({ io, packageRegistry, resolvePackageKind, json = false } = {})`
+- `renderAddCatalogHelp({ io, packageRegistry, bundleRegistry, resolvePackageKind, json = false } = {})`
+- `renderGeneratePackageHelp({ io, packageEntry, packageIdInput = "", json = false } = {})`
+- `renderGenerateSubcommandHelp({ io, packageEntry, packageIdInput = "", subcommandName = "", json = false } = {})`
+- `renderAddPackageHelp({ io, packageEntry, packageIdInput = "", json = false } = {})`
+- `renderAddBundleHelp({ io, bundleId = "", bundle = {}, json = false } = {})`
+Local functions
+- `toShortPackageId(packageId = "")`
+- `resolvePackageSummary(entry = {})`
+- `resolveHelpText(rawValue = "", helpTextKey = "")`
+- `buildPackageOptionRows(packageEntry = {})`
+- `normalizeSubcommandPositionalArgRows(rawRows = [])`
+- `normalizeSubcommandOptionNames(rawOptionNames = [])`
+- `normalizeHelpExampleRows(rawRows = [])`
+- `normalizeHelpNoteRows(rawRows = [])`
+- `normalizeHelpParagraphRows(rawValue = "")`
+- `appendHelpLongDescription(lines = [], rawLongDescription = "", { color = null } = {})`
+- `appendHelpExamples(lines = [], exampleRows = [], { color = null } = {})`
+- `appendHelpNotes(lines = [], rawNotes = [], { color = null } = {})`
+- `appendSeparatedBlocks(lines = [], blocks = [])`
+- `resolveGeneratorSubcommandMetadata(packageEntry = {})`
+- `formatOptionSummary(optionRow = {}, { color = null } = {})`
+- `formatPositionalArgUsageToken(arg = {})`
+- `formatPositionalArgSummary(arg = {}, { color = null } = {})`
+- `findGeneratorSubcommandRow(packageEntry = {}, subcommandName = "")`
+- `buildSubcommandOptionRows(optionRows = [], subcommandRow = {})`
+
+### `src/server/commandHandlers/packageCommands/generate.js`
+Exports
+- `runPackageGenerateCommand(ctx = {}, { positional, options, cwd, io }, { runCommandAdd })`
+Local functions
+- `resolveGeneratorSubcommandDefinitionMetadata(packageEntry = {}, subcommandName = "")`
+- `resolveSubcommandRequiresShellWeb(packageEntry = {}, subcommandName = "")`
+- `mapDescriptorBackedSubcommandArgsToInlineOptions(packageEntry = {}, subcommandName = "", subcommandArgs = [], inlineOptions = {}, createCliError)`
+- `resolveSubcommandRequiresInput(packageEntry = {}, subcommandName = "")`
+- `collectUnexpectedGeneratorSubcommandOptionNames(packageEntry = {}, subcommandName = "", inlineOptions = {})`
+- `resolveCreateTargetPolicy(packageEntry = {}, subcommandName = "")`
+- `normalizeRelativePathWithinApp(appRoot = "", targetPath = "", createCliError)`
+- `enforceDescriptorBackedCreateTargetPolicy({ packageEntry, subcommandName, inlineOptions = {}, appRoot = "", packageIdInput = "", createCliError, readdir } = {})`
+
+### `src/server/commandHandlers/packageCommands/migrations.js`
+Exports
+- `runPackageMigrationsCommand(ctx = {}, { positional, options, cwd, io })`
+
+### `src/server/commandHandlers/packageCommands/position.js`
+Exports
+- `runPackagePositionCommand(ctx = {}, { positional, options, cwd, io })`
+
+### `src/server/commandHandlers/packageCommands/remove.js`
+Exports
+- `runPackageRemoveCommand(ctx = {}, { positional, options, cwd, io })`
+
+### `src/server/commandHandlers/packageCommands/tabLinkItemProvisioning.js`
+Exports
+- `LOCAL_LINK_ITEM_COMPONENT_TOKENS`
+- `TAB_LINK_COMPONENT_TOKEN`
+- `collectProvisionableLocalPlacementComponentTokensFromApp({ appRoot = "" } = {})`
+- `resolveProvisionableLocalPlacementComponentTokens({ appRoot = "", componentTokens = [] } = {})`
+- `ensureLocalMainPlacementComponentProvisioning({ appRoot = "", createCliError, dryRun = false, touchedFiles = new Set(), componentTokens = [] } = {})`
+- `ensureLocalMainTabLinkItemProvisioning({ appRoot = "", createCliError, dryRun = false, touchedFiles = new Set() } = {})`
+Local functions
+- `toPosixPath(value = "")`
+- `ensureTrailingNewline(value = "")`
+- `insertImportIfMissing(source = "", importLine = "")`
+- `insertBeforeClassDeclaration(source = "", line = "", { className = "", contextFile = "" } = {})`
+- `readUtf8FileIfExists(absolutePath = "")`
+- `ensureProvisionedComponentFile(definition, { appRoot = "", dryRun = false, touchedFiles = new Set() } = {})`
+- `hasProvisionedTokenRegistration(providerSource = "", componentToken = "")`
+- `loadMainClientProviderSource({ appRoot = "", createCliError, componentToken = "" } = {})`
+- `ensureProvisionedProviderRegistration(definition, { appRoot = "", createCliError, dryRun = false, touchedFiles = new Set() } = {})`
+
+### `src/server/commandHandlers/packageCommands/update.js`
+Exports
+- `runPackageUpdateCommand(ctx = {}, { positional, options, cwd, io }, { runCommandAdd })`
+
+### `src/server/commandHandlers/shared.js`
+Exports
+- `createCommandHandlerShared(ctx = {})`
+
+### `src/server/commandHandlers/show.js`
+Exports
+- `createShowCommand(ctx = {})`
+
+### `src/server/commandHandlers/show/payloads.js`
+Exports
+- `buildBundleShowPayload(bundle = {})`
+- `buildPackageShowPayload({ packageRegistry, packageEntry, options, inspectPackageOfferings, buildFileWriteGroups, listDeclaredCapabilities, buildCapabilityDetailsForPackage } = {})`
+
+### `src/server/commandHandlers/show/renderBundleText.js`
+Exports
+- `renderBundlePayloadText({ payload, stdout, color, writeField } = {})`
+
+### `src/server/commandHandlers/show/renderHelpers.js`
+Exports
+- `createShowRenderHelpers({ stdout, color, options, deriveProviderDisplayName } = {})`
+
+### `src/server/commandHandlers/show/renderPackageCapabilities.js`
+Exports
+- `writeCapabilitiesSections({ payload, provides, requires, capabilityDetails, stdout, color, wrapWidth, writeWrappedItems } = {})`
+Local functions
+- `writeCapabilityRecord({ heading, records, includeDependsOnProviders = false, stdout, color, wrapWidth, writeWrappedItems } = {})`
+- `formatPackageSummary(detail)`
+
+### `src/server/commandHandlers/show/renderPackageExports.js`
+Exports
+- `writePackageExportsSection({ payload, options, stdout, color, wrapWidth, normalizeRelativePosixPath, shouldShowPackageExportTarget, classifyExportedSymbols, writeWrappedItems } = {})`
+Local functions
+- `writeClassifiedSymbols({ label, entries, stdout, color, wrapWidth, writeWrappedItems } = {})`
+
+### `src/server/commandHandlers/show/renderPackageText.js`
+Exports
+- `renderPackagePayloadText({ payload, provides, requires, capabilityDetails, options, stdout, color, resolveWrapWidth, writeWrappedItems, normalizeRelativePosixPath, formatPackageSubpathImport, normalizePlacementOutlets, normalizePlacementContributions, shouldShowPackageExportTarget, classifyExportedSymbols, deriveProviderDisplayName } = {})`
+
+### `src/server/core/argParser.js`
+Exports
+- `parseArgs(argv, { createCliError } = {})`
+
+### `src/server/core/buildCommandDeps.js`
+Exports
+- `createCommandHandlerDeps(deps = {})`
+
+### `src/server/core/commandCatalog.js`
+Exports
+- `COMMAND_IDS`
+- `OPTION_FLAG_LABELS`
+- `resolveCommandAlias(rawCommand)`
+- `resolveCommandDescriptor(rawCommand)`
+- `isKnownCommandName(rawCommand)`
+- `listOverviewCommandDescriptors()`
+- `shouldShowCommandHelpOnBareInvocation(command = "", positional = [])`
+- `validateCommandOptions({ command = "", positional = [], options = {} } = {}, { createCliError, renderUsage = null } = {})`
+Local functions
+- `isHelpToken(value = "")`
+- `canDelegateAddInlineOptions(positional = [])`
+- `canDelegateGenerateInlineOptions(positional = [])`
+- `canDelegateMigrationsInlineOptions(positional = [])`
+- `canDelegatePackageTargetInlineOptions(positional = [], expectedTargetType = "")`
+- `sortOptionLabels(labels = [])`
+
+### `src/server/core/createCliRunner.js`
+Exports
+- `runCli`
+
+### `src/server/core/createCommandHandlers.js`
+Exports
+- `createCommandHandlers(deps = {})`
+
+### `src/server/core/dispatchCli.js`
+Exports
+- `createRunCli({ parseArgs, printUsage, shouldShowCommandHelpOnBareInvocation, validateCommandOptions, resolveCommandDescriptor, commandHandlers, cleanupMaterializedPackageRoots, createCliError } = {})`
+
+### `src/server/core/usageHelp.js`
+Exports
+- `printUsage(stream = process.stderr, { command = "" } = {})`
+- `shouldShowCommandHelpOnBareInvocation`
+Local functions
+- `appendSeparatedBlocks(lines = [], blocks = [])`
+- `writeHelpLines(stream, lines = [])`
+- `printTopLevelHelp(stream = process.stderr)`
+- `printCommandHelp(stream = process.stderr, command = "")`
+
+### `src/server/index.js`
+Exports
+- `runCli`
+
+### `src/server/shared/cliError.js`
+Exports
+- `createCliError(message, { showUsage = false, exitCode = 1, renderUsage = null } = {})`
+
+### `src/server/shared/collectionUtils.js`
+Exports
+- `ensureArray(value)`
+- `ensureObject(value)`
+- `sortStrings(values)`
+
+### `src/server/shared/optionInterpolation.js`
+Exports
+- `appendTextSnippet(content, snippet, position = "bottom")`
+- `escapeRegExp(value)`
+- `interpolateOptionValue(rawValue, options, ownerId, key)`
+- `normalizeSkipChecks(value)`
+- `promptForRequiredOption({ ownerType, ownerId, optionName, optionSchema, promptChoices = [], stdin = process.stdin, stdout = process.stdout })`
+Local functions
+- `normalizeSnippet(value)`
+- `splitTextIntoWords(value)`
+- `wordsToPascal(words)`
+- `wordsToCamel(words)`
+- `wordsToSnake(words)`
+- `wordsToKebab(words)`
+- `resolveLastWordMutationInput(value)`
+- `toSingularForm(value)`
+- `toPluralForm(value)`
+- `normalizePathValue(value)`
+- `normalizePromptChoices(rawChoices = [])`
+- `findPromptChoice(promptChoices = [], answer = "")`
+- `promptForChoice({ promptText = "", promptChoices = [], stdin, stdout, required = false, defaultValue = "" })`
+- `parseTransformSpec(transform)`
+- `applyOptionTransform(value, transform, ownerId, key, optionName)`
+- `applyOptionTransformPipeline(rawValue, rawPipeline, ownerId, key, optionName)`
+- `isSecretOptionInput(optionSchema)`
+- `createMutedReadlineOutput(stdout)`
+
+### `src/server/shared/outputFormatting.js`
+Exports
+- `createColorFormatter(stream)`
+- `renderInlineCodeSpans(text = "", color = null)`
+- `resolveWrapWidth(stream, fallbackWidth = 80)`
+- `writeWrappedLines({ stdout, lines, wrapWidth } = {})`
+- `writeWrappedItems({ stdout, heading, items, lineIndent = " ", wrapWidth = 80 })`
+Local functions
+- `measureVisibleLength(text = "")`
+- `resolveLeadingWhitespace(text = "")`
+- `buildContinuationIndent({ prefix = "", fallbackPrefix = "" } = {})`
+- `resolveWrapPrefixes(line = "")`
+- `wrapOutputLine(line = "", { wrapWidth = 80 } = {})`
+
+### `src/server/shared/packageIdHelpers.js`
+Exports
+- `toScopedPackageId(input)`
+- `resolvePackageIdInput(input, packageRegistry)`
+- `resolveInstalledPackageIdInput(input, installedPackages)`
+
+### `src/server/shared/pathResolution.js`
+Exports
+- `CLI_PACKAGE_ROOT`
+- `BUNDLES_ROOT`
+- `CATALOG_PACKAGES_PATH`
+Local functions
+- `resolveCatalogPackagesPath()`
+
+### bin
+
+### `bin/jskit.js`
+Exports
+- None
+
+### bundles
+
+### `bundles/auth-base/bundle.descriptor.mjs`
+Exports
+- None

package/reference/autogen/tooling/test-support.md

@@ -0,0 +1,27 @@
+# tooling/test-support
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/test-support`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/test-support/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### root
+
+### `exportsContract.mjs`
+Exports
+- `evaluatePackageExportsContract({ repoRoot, packageDir, packageId, requiredExports = [], scanRoots = [ path.join(repoRoot, "packages"), path.join(repoRoot, "tooling", "create-app", "templates") ] })`
+Local functions
+- `normalizeSlash(value)`
+- `shouldScanFile(filePath)`
+- `walkFiles(directoryPath)`
+- `toExportKey(importSubpath)`
+- `collectScanFiles(scanRoots = [])`
+- `isUsageFile(filePath, { repoRoot, packageRelativeRoot })`
+- `collectPackageImportUsages({ repoRoot, packageId, packageRelativeRoot, scanRoots })`

package/reference/autogen/tooling/testUtils.md

@@ -0,0 +1,31 @@
+# tooling/testUtils
+
+Generated by `npm run agent-docs:build`.
+Do not edit manually.
+
+Generated inventory for `tooling/testUtils`.
+Use this on demand; do not load the full index at startup.
+
+## Scope
+- Source: `tooling/testUtils/**/*{.js,.mjs,.cjs,.vue}`
+- Excludes: `test/`, `tests/`, `__tests__/`, `*.test.*`, `*.spec.*`, `*.vitest.*`, `node_modules/`, `dist/`, `coverage/`, `docs/`, `LEGACY/`
+
+## Sections
+
+### root
+
+### `fakeFastify.mjs`
+Exports
+- `createFakeFastifyPolicyRuntime({ csrfHandler, autoRunPlugin = null } = {})`
+
+### `runCli.js`
+Exports
+- `createCliRunner(cliPath)`
+
+### `runJskit.mjs`
+Exports
+- `runJskit({ cwd, args = [], input = undefined } = {})`
+
+### `tempDir.mjs`
+Exports
+- `withTempDir(run, { prefix = "jskit-test-" } = {})`