@axinom/mosaic-agent-skills 0.0.1

package/skills/_shared/conventions/field-component-mapping.md

@@ -0,0 +1,155 @@
+---
+name: field-component-mapping
+input:
+  - EntityFeatures.fields.scalars[]
+  - EntityFeatures.fields.associations
+output:
+  - Component selection rules for each field type
+---
+
+# Field Component Mapping
+
+Maps GraphQL types to `@axinom/mosaic-ui` form components.
+
+## Scalar Fields
+
+| GraphQL Type    | Component                       | Props                   | Notes                                          |
+| --------------- | ------------------------------- | ----------------------- | ---------------------------------------------- |
+| `String`        | `SingleLineTextField`           | -                       | Use for short single-line texts (title, name)  |
+| `String` (long) | `TextAreaField`                 | -                       | Use for lengthy multi-line texts (description) |
+| `Int` / `Float` | `SingleLineTextField`           | `type="number"`         | Numeric input                                  |
+| `Boolean`       | `CheckboxField` or `RadioField` | See below               | AI decides based on context                    |
+| `Date`          | `DateTimeTextField`             | `modifyTime={false}`    | Date only                                      |
+| `Datetime`      | `DateTimeTextField`             | -                       | Date and time                                  |
+| `Enum`          | `SelectField`                   | `options={enumOptions}` | Dropdown with enum values                      |
+
+## Association Fields
+
+| Association Type        | Component         | Props                                |
+| ----------------------- | ----------------- | ------------------------------------ |
+| TagLike (autocomplete)  | `CustomTagsField` | `liveSuggestionsResolver={resolver}` |
+| ManyToMany (fixed list) | `TagsField`       | `tagsOptions={options}`              |
+
+---
+
+## Examples
+
+### String (short)
+
+```tsx
+<Field name="title" label="Title" as={SingleLineTextField} />
+```
+
+### String (long)
+
+Detected by field name containing: `description`, `notes`, `comment`, `body`,
+`content`
+
+```tsx
+<Field name="description" label="Description" as={TextAreaField} />
+```
+
+### Int / Float
+
+```tsx
+<Field
+  type="number"
+  name="index"
+  label="Episode Index"
+  as={SingleLineTextField}
+/>
+```
+
+### Boolean - CheckboxField
+
+Simple on/off toggle:
+
+```tsx
+<Field name="allowSignUp" label="Allow Sign Up" as={CheckboxField} />
+```
+
+### Boolean - RadioField
+
+Explicit labels (Active/Inactive, Enabled/Disabled):
+
+```tsx
+<Field
+  name="enabled"
+  label="Status"
+  options={[
+    { value: true, label: 'Enabled' },
+    { value: false, label: 'Disabled' },
+  ]}
+  transform={(value: string) => JSON.parse(value)}
+  as={RadioField}
+/>
+```
+
+### Date
+
+```tsx
+<Field
+  name="released"
+  label="Release Date"
+  as={DateTimeTextField}
+  modifyTime={false}
+/>
+```
+
+### Datetime
+
+```tsx
+<Field name="createdAt" label="Created At" as={DateTimeTextField} />
+```
+
+### Enum
+
+Extract enum values from GraphQL schema:
+
+```tsx
+// GraphQL: enum ContentType { MAIN | TRAILER | EXTRA }
+<Field
+  name="contentType"
+  label="Content Type"
+  options={[
+    { value: ContentType.Main, label: 'Main' },
+    { value: ContentType.Trailer, label: 'Trailer' },
+    { value: ContentType.Extra, label: 'Extra' },
+  ]}
+  as={SelectField}
+/>
+```
+
+### TagLike (autocomplete)
+
+With live suggestions resolver:
+
+```tsx
+const tagsResolver = async (value: string): Promise<(string | null)[]> => {
+  const { data } = await client.query<SearchMovieTagsQuery>({
+    query: SearchMovieTagsDocument,
+    variables: { searchKey: value, limit: 10 },
+  });
+  return data.getMoviesTagsValues?.nodes ?? [];
+};
+
+<Field
+  name="tags"
+  label="Tags"
+  liveSuggestionsResolver={tagsResolver}
+  as={CustomTagsField}
+/>;
+```
+
+### ManyToMany (fixed list)
+
+With predefined options:
+
+```tsx
+<Field
+  name="genres"
+  label="Genres"
+  tagsOptions={genresOptions}
+  as={TagsField}
+/>
+```

package/skills/_shared/conventions/field-validation-schema.md

@@ -0,0 +1,77 @@
+---
+name: field-validation-schema
+input:
+  - EntityFeatures.fields.scalars[]
+output:
+  - Yup validation schema rules
+---
+
+# Field Validation Schema
+
+Yup validation patterns based on existing implementations.
+
+## Validation Mapping
+
+| GraphQL Type      | Yup Validation                      | Notes                                                  |
+| ----------------- | ----------------------------------- | ------------------------------------------------------ |
+| `String`          | `Yup.string().max(length).min(min)` | Use `scalar.constraints.maxLength/minLength` if exists |
+| `Int`             | `Yup.number().integer().positive()` | Positive integers                                      |
+| `Float`           | `Yup.number().positive()`           | Positive numbers                                       |
+| `Boolean`         | `Yup.boolean()`                     | Boolean validation                                     |
+| `Date`/`Datetime` | `Yup.date()`                        | Date validation                                        |
+| `Enum`            | `Yup.string()`                      | SelectField handles validation                         |
+
+## Required Fields
+
+Add `.required('{Label} is a required field')` if `scalar.isRequired === true`
+
+## Optional Fields
+
+Add `.nullable()` if `scalar.isRequired === false`
+
+## String Length Constraints
+
+- Use `scalar.constraints.maxLength` if available
+- Use `scalar.constraints.minLength` if available
+- Only add `.max()` or `.min()` when constraint exists
+
+## Example Schema
+
+```typescript
+const {entityCamel}DetailSchema = Yup.object<
+  ObjectSchemaDefinition<{Entity}DetailsFormData>
+>({
+  // String field with maxLength constraint (required)
+  // scalar.constraints.maxLength = 100
+  title: Yup.string()
+    .required('Title is a required field')
+    .max(100),
+
+  // String field with no constraints (optional)
+  externalId: Yup.string().nullable(),
+
+  // String field with both minLength and maxLength (optional)
+  // scalar.constraints.minLength = 3, maxLength = 50
+  code: Yup.string()
+    .min(3)
+    .max(50)
+    .nullable(),
+
+  // Number field (required)
+  index: Yup.number()
+    .integer()
+    .positive('Index must be a positive number')
+    .required('Index is a required field'),
+
+  // Boolean field (required)
+  enabled: Yup.boolean().required(),
+
+  // Date field (optional)
+  released: Yup.date().nullable(),
+});
+```
+
+## Notes
+
+- Only add `.max()` or `.min()` when `scalar.constraints` contains the value
+- Numbers default to `.positive()`

package/skills/_shared/discovery/discover-paths.md

@@ -0,0 +1,52 @@
+---
+name: discover-paths
+input:
+  - Entity name (e.g., Movie, ServiceAccount, Aircraft)
+output:
+  - DiscoveredPaths object
+---
+
+# Discover Project Paths
+
+```typescript
+interface DiscoveredPaths {
+  /**
+   * Absolute path to GraphQL schema file.
+   * Discovery: Search for `type {EntityName}` in `services/%/service/src/generated/graphql/schema.graphql` files.
+   * If multiple or none found → ask user which service.
+   */
+  schemaPath: string;
+
+  /**
+   * Path to Apollo Client instance.
+   * Discovery: Search for `export.%client.%ApolloClient` in `workflows/src/` (typically `apolloClient.ts` or `client.ts`)
+   */
+  apolloClientPath: string;
+
+  /**
+   * Path to codegen output directory.
+   * Typically a `graphql.tsx` file inside a `generated` folder such as `workflows/src/generated`.
+   */
+  generatedTypesPath: string;
+
+  /**
+   * Path to workflows directory.
+   * Typically `services/{serviceName}/workflows`
+   */
+  workflowsPath: string;
+
+  /**
+   * Service name (e.g., "media", "fleet", "video").
+   * Extract from schema path: `services/{serviceName}/service/...`
+   * Used in extract phase to compute `serviceId` and `permissions`.
+   */
+  serviceName: string;
+
+  /**
+   * Path to `ExtensionsContext` export.
+   * Discovery: Search for `export.*ExtensionsContext` in `workflows/src/` (typically `workflows/src/externals/piralExtensions.tsx`)
+   * If not found: Skip dependencies of `ExtensionsContext` (i.e. for image/video rendering) and add a `TODO`
+   */
+  extensionsContextPath?: string;
+}
+```