@jskit-ai/agent-docs 0.1.16 → 0.1.18

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

@@ -54,48 +54,28 @@ Exports
 
 ### `src/server/common/repositories/workspaceInvitesRepository.js`
 Exports
-- `createRepository(knex)`
+- `createRepository({ api, knex } = {})`
 - `normalizeInviteRecord(payload)`
 - `normalizeInviteWithWorkspace(payload = {})`
 Local functions
 - `normalizeInvitePatchPayload(payload = {})`
+- `createInviteRelationships({ workspaceId = null, invitedByUserId = undefined } = {})`
 
 ### `src/server/common/repositories/workspaceMembershipsRepository.js`
 Exports
-- `createRepository(knex)`
+- `createRepository({ api, knex } = {})`
 - `normalizeMembershipRecord(payload)`
 - `normalizeMemberSummaryRow(row)`
 Local functions
 - `normalizeMembershipPatchPayload(payload = {})`
+- `createMembershipRelationships({ workspaceId = null, userId = null } = {})`
 
 ### `src/server/common/repositories/workspacesRepository.js`
 Exports
-- `createRepository(knex)`
-- `normalizeWorkspaceRecord(payload)`
-- `normalizeMembershipWorkspaceRow(row)`
+- `createRepository({ api, knex } = {})`
 Local functions
-- `normalizeCreatePayload(payload = {})`
-
-### `src/server/common/resources/workspaceInvitesResource.js`
-Exports
-- `workspaceInvitesResource`
-Local functions
-- `normalizeInviteRecord(payload = {})`
-- `normalizeInviteInput(payload = {})`
-
-### `src/server/common/resources/workspaceMembershipsResource.js`
-Exports
-- `workspaceMembershipsResource`
-Local functions
-- `normalizeMembershipRecord(payload = {})`
-- `normalizeMembershipInput(payload = {})`
-
-### `src/server/common/resources/workspacesResource.js`
-Exports
-- `workspacesResource`
-Local functions
-- `normalizeWorkspaceRecord(payload = {})`
-- `normalizeWorkspaceInput(payload = {})`
+- `normalizeWorkspaceRecord(payload = null)`
+- `createWorkspaceRelationships(source = {})`
 
 ### `src/server/common/services/workspaceContextService.js`
 Exports
@@ -129,19 +109,10 @@ Exports
 - `WORKSPACE_ROUTE_BASE_PATH`
 - `resolveWorkspaceRoutePath(relativePath = "/")`
 
-### `src/server/common/validators/authenticatedUserValidator.js`
-Exports
-- `authenticatedUserValidator`
-Local functions
-- `normalizeAuthenticatedUser(input = {})`
-
 ### `src/server/common/validators/routeParamsValidator.js`
 Exports
 - `routeParamsValidator`
 - `workspaceSlugParamsValidator`
-Local functions
-- `normalizeRouteParams(input = {})`
-- `normalizeWorkspaceSlugParams(input = {})`
 
 ### `src/server/registerWorkspaceBootstrap.js`
 Exports
@@ -190,7 +161,6 @@ Exports
 Exports
 - `createWorkspaceBootstrapContributor({ workspaceService, workspacePendingInvitationsService, userProfilesRepository, workspaceInvitationsEnabled = false, appConfig = {}, tenancyProfile = null } = {})`
 Local functions
-- `normalizePendingInvites(invites)`
 - `normalizeQueryPayload(value = {})`
 - `resolveBootstrapWorkspaceSlug({ query = {}, request = null } = {})`
 - `normalizeRequestedWorkspaceStatus(value = "")`
@@ -201,6 +171,8 @@ Local functions
 ### `src/server/workspaceDirectory/bootWorkspaceDirectoryRoutes.js`
 Exports
 - `bootWorkspaceDirectoryRoutes(app)`
+Local functions
+- `resolveWorkspaceRecordId(record = {}, context = {})`
 
 ### `src/server/workspaceDirectory/registerWorkspaceDirectory.js`
 Exports
@@ -213,6 +185,8 @@ Exports
 ### `src/server/workspaceMembers/bootWorkspaceMembers.js`
 Exports
 - `bootWorkspaceMembers(app)`
+Local functions
+- `resolveWorkspaceAggregateRecordId(record = {}, context = {})`
 
 ### `src/server/workspaceMembers/registerWorkspaceMembers.js`
 Exports
@@ -231,6 +205,8 @@ Exports
 ### `src/server/workspacePendingInvitations/bootWorkspacePendingInvitations.js`
 Exports
 - `bootWorkspacePendingInvitations(app)`
+Local functions
+- `resolveAuthenticatedUserRecordId(_record, context = {})`
 
 ### `src/server/workspacePendingInvitations/registerWorkspacePendingInvitations.js`
 Exports
@@ -257,6 +233,8 @@ Exports
 ### `src/server/workspaceSettings/bootWorkspaceSettings.js`
 Exports
 - `bootWorkspaceSettings(app)`
+Local functions
+- `resolveWorkspaceSettingsRecordId(record = {}, context = {})`
 
 ### `src/server/workspaceSettings/registerWorkspaceSettings.js`
 Exports
@@ -270,65 +248,67 @@ Exports
 
 ### `src/server/workspaceSettings/workspaceSettingsRepository.js`
 Exports
-- `createRepository(knex, { defaultInvitesEnabled } = {})`
+- `createRepository({ api, knex } = {})`
 Local functions
-- `resolveWorkspaceSettingsSeed(workspace = {}, { defaultInvitesEnabled = true } = {})`
+- `pickPatchFields(source = {})`
+- `createDefaultWorkspaceSettingsCreatePayload(workspaceId)`
 
 ### `src/server/workspaceSettings/workspaceSettingsService.js`
 Exports
 - `createService({ workspaceSettingsRepository, workspaceInvitationsEnabled = true, roleCatalog = null } = {})`
 
+### `src/shared/jsonApiTransports.js`
+Exports
+- `WORKSPACES_TRANSPORT`
+- `WORKSPACES_COLLECTION_TRANSPORT`
+- `WORKSPACE_SETTINGS_TRANSPORT`
+- `WORKSPACE_ROLE_CATALOG_TRANSPORT`
+- `WORKSPACE_MEMBERS_TRANSPORT`
+- `WORKSPACE_MEMBER_ROLE_UPDATE_TRANSPORT`
+- `WORKSPACE_INVITES_TRANSPORT`
+- `WORKSPACE_INVITE_CREATE_TRANSPORT`
+- `WORKSPACE_INVITE_REDEEM_TRANSPORT`
+- `WORKSPACE_PENDING_INVITATIONS_TRANSPORT`
+
 ### `src/shared/operationMessages.js`
 Exports
 - `createOperationMessages({ validationMessage = "Validation failed.", apiValidationMessage = validationMessage } = {})`
 
-### `src/shared/resources/resolveGlobalArrayRegistry.js`
+### `src/shared/resources/workspaceInvitesResource.js`
 Exports
-- `resolveGlobalArrayRegistry(symbolKey)`
+- `workspaceInvitesResource`
+
+### `src/shared/resources/workspaceMembershipsResource.js`
+Exports
+- `workspaceMembershipsResource`
 
 ### `src/shared/resources/workspaceMembersResource.js`
 Exports
 - `workspaceMembersResource`
-Local functions
-- `normalizeWorkspaceAdminSummary(workspace)`
-- `normalizeMemberSummary(member, workspace)`
-- `normalizeInviteSummary(invite)`
-- `normalizeWorkspaceOutputEnvelope(payload = {}, { itemsKey, normalizeItem, includeInviteTokenPreview = false } = {})`
-- `normalizeWorkspaceMembersOutput(payload = {})`
-- `normalizeWorkspaceInvitesOutput(payload = {})`
 
 ### `src/shared/resources/workspacePendingInvitationsResource.js`
 Exports
 - `workspacePendingInvitationsResource`
-Local functions
-- `normalizePendingInvite(invite)`
-- `normalizePendingInviteList(invites)`
 
 ### `src/shared/resources/workspaceResource.js`
 Exports
 - `workspaceResource`
+- `workspaceListItemOutputValidator`
 Local functions
 - `normalizeWorkspaceAvatarUrl(value)`
-- `normalizeWorkspaceInput(payload = {})`
-- `normalizeWorkspaceOutput(payload = {})`
-- `normalizeWorkspaceListItemOutput(payload = {})`
 
-### `src/shared/resources/workspaceSettingsFields.js`
+### `src/shared/resources/workspaceRoleCatalogSchema.js`
 Exports
-- `defineField(field = {})`
-- `resetWorkspaceSettingsFields()`
-- `resolveWorkspaceSettingsFieldKeys()`
-- `workspaceSettingsFields`
+- `workspaceRoleCatalogSchema`
+- `workspaceRoleDescriptorSchema`
 
 ### `src/shared/resources/workspaceSettingsResource.js`
 Exports
+- `WORKSPACE_SETTINGS_FIELD_KEYS`
+- `workspaceSettingsOutputSchema`
 - `workspaceSettingsResource`
 Local functions
-- `buildCreateBodySchema()`
-- `buildSettingsOutputSchema()`
-- `buildResponseRecordSchema()`
-- `normalizeInput(payload = {})`
-- `normalizeOutput(payload = {})`
+- `normalizeWorkspaceColorInput(value)`
 
 ### `src/shared/roles.js`
 Exports
@@ -428,20 +408,8 @@ Local functions
 - `hasColumn(knex, tableName, columnName)`
 - `normalizeHexColor(value)`
 
-### `templates/packages/main/src/shared/resources/workspaceSettingsFields.js`
-Exports
-- None
-Local functions
-- `normalizeHexColor(value)`
-
 ### root
 
 ### `package.descriptor.mjs`
 Exports
 - None
-
-### test-support
-
-### `test-support/registerDefaultSettingsFields.js`
-Exports
-- None

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

@@ -270,7 +270,7 @@ Exports
 - `WORKSPACE_BOOTSTRAP_STATUS_FORBIDDEN`
 - `WORKSPACE_BOOTSTRAP_STATUS_UNAUTHENTICATED`
 - `WORKSPACE_BOOTSTRAP_STATUS_ERROR`
-- `createBootstrapPlacementRuntime({ app, logger = null, fetchBootstrap = fetchBootstrapPayload } = {})`
+- `createBootstrapPlacementRuntime({ app, logger = null } = {})`
 
 ### `src/client/runtime/bootstrapPlacementRuntimeConstants.js`
 Exports
@@ -318,8 +318,6 @@ Exports
 - `WORKSPACES_WEB_SCOPE_SUPPORT_INJECTION_KEY`
 - `createWorkspaceScopeSupport()`
 - `readWorkspaceRouteScope(routeContext = {})`
-Local functions
-- `unwrapRefValue(value)`
 
 ### `src/shared/toolsOutletContracts.js`
 Exports

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

@@ -166,7 +166,7 @@ Exports
 
 ### `src/server/cliRuntime/mutations/fileMutations.js`
 Exports
-- `applyFileMutations(packageEntry, appRoot, preparedMutations, managedFiles, managedMigrations, touchedFiles, warnings = [], existingManagedFiles = [])`
+- `applyFileMutations(packageEntry, appRoot, preparedMutations, managedFiles, managedMigrations, touchedFiles, warnings = [], existingManagedFiles = [], { reapplyManagedAppFiles = false } = {})`
 - `prepareFileMutations(packageEntry, options, appRoot, fileMutations, existingManagedFiles = [])`
 
 ### `src/server/cliRuntime/mutations/installMigrationMutation.js`
@@ -198,8 +198,6 @@ Exports
 - `partitionPreFileConfigTextMutations(textMutations = [])`
 - `resolvePositioningMutations(descriptorMutations = {})`
 Local functions
-- `resolveSettingsFieldsContractTarget(relativeFile = "")`
-- `validateSettingsFieldsContractMutationTarget({ appRoot, relativeFile, packageId } = {})`
 - `isPositioningTextMutation(value = {})`
 - `isPreFileConfigTextMutation(value = {})`
 
@@ -228,6 +226,9 @@ Local functions
 - `createManagedRecordBase(packageEntry, options)`
 - `cloneManagedMap(value = {})`
 - `cloneManagedArray(value = [])`
+- `normalizeModeToken(value = "")`
+- `isWorkspaceCapableTenancyMode(value = "")`
+- `collectInstallWarnings({ packageEntry, appRoot, appPackageJson })`
 - `resolveManagedSourceRecord(packageEntry, existingInstall = {})`
 
 ### `src/server/cliRuntime/packageIntrospection.js`
@@ -351,8 +352,8 @@ Local functions
 ### `src/server/commandHandlers/appCommandCatalog.js`
 Exports
 - `APP_SCRIPT_WRAPPERS`
-- `LEGACY_APP_SCRIPT_VALUES`
-- `LEGACY_APP_SCRIPT_FILES`
+- `COPIED_APP_SCRIPT_VALUES`
+- `COPIED_APP_SCRIPT_FILES`
 - `APP_COMMAND_DEFINITIONS`
 - `listAppCommandDefinitions()`
 - `resolveAppCommandDefinition(rawName = "")`

package/workflow/feature-delivery.md

@@ -32,7 +32,8 @@ For CRUD chunks:
 2. If `crud-server-generator` is going to own the CRUD schema, do not hand-write a separate migration for that CRUD table.
 3. Scaffold the server side first with `crud-server-generator`.
 4. Only after the shared resource file exists, scaffold the client side against that resource.
-5. Do not guess CRUD operations or screen shape. Ask the developer:
+5. Treat that shared resource file as the canonical CRUD definition. Put field and ownership changes there instead of hand-duplicating derived CRUD validators elsewhere.
+6. Do not guess CRUD operations or screen shape. Ask the developer:
    - which operations are allowed
    - which fields belong in the list view if one exists
    - what the view form should look like