apiresourceschema-projects.ai.kedge.faros.sh.yaml

apiVersion: apis.kcp.io/v1alpha1
kind: APIResourceSchema
metadata:
  name: v260711-a1a2bb6.projects.ai.kedge.faros.sh
spec:
  group: ai.kedge.faros.sh
  names:
    kind: Project
    listKind: ProjectList
    plural: projects
    shortNames:
    - proj
    singular: project
  scope: Cluster
  versions:
  - additionalPrinterColumns:
    - jsonPath: .spec.displayName
      name: DisplayName
      type: string
    - jsonPath: .status.phase
      name: Phase
      type: string
    - jsonPath: .status.updatedAt
      name: Updated
      type: date
    - jsonPath: .metadata.creationTimestamp
      name: Age
      type: date
    name: v1alpha1
    schema:
      description: Project is a persistent AI workspace scoped to a Kedge child workspace.
      properties:
        apiVersion:
          description: |-
            APIVersion defines the versioned schema of this representation of an object.
            Servers should convert recognized schemas to the latest internal value, and
            may reject unrecognized values.
            More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
          type: string
        kind:
          description: |-
            Kind is a string value representing the REST resource this object represents.
            Servers may infer this from the endpoint the client submits requests to.
            Cannot be updated.
            In CamelCase.
            More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
          type: string
        metadata:
          type: object
        spec:
          description: ProjectSpec defines user-authored Project state.
          properties:
            description:
              description: Description is a short project summary.
              maxLength: 2048
              type: string
            displayName:
              description: DisplayName is the human-readable project title.
              maxLength: 128
              minLength: 1
              type: string
            environments:
              description: |-
                Environments describe provider-backed runtime capabilities for this
                Project. App Studio owns the binding contract; providers own runtime
                implementation details.
              items:
                properties:
                  autoDeploy:
                    description: AutoDeploy marks artifact environments that should
                      deploy automatically.
                    type: boolean
                  bindings:
                    description: Bindings connect this environment to provider capabilities.
                    items:
                      properties:
                        kind:
                          type: string
                        name:
                          maxLength: 63
                          minLength: 1
                          type: string
                        provider:
                          maxLength: 63
                          minLength: 1
                          type: string
                        resourceRef:
                          properties:
                            apiVersion:
                              type: string
                            kind:
                              type: string
                            name:
                              type: string
                            resource:
                              type: string
                          type: object
                        values:
                          description: |-
                            Values is provider-owned configuration. App Studio treats it as an
                            opaque contract payload.
                          type: object
                          x-kubernetes-preserve-unknown-fields: true
                      required:
                      - kind
                      - name
                      - provider
                      type: object
                    type: array
                  mode:
                    description: |-
                      Mode distinguishes artifact-based environments from live development
                      runtimes. Empty means artifact for backward compatibility.
                    type: string
                  name:
                    description: Name is a stable environment identifier such as development
                      or test.
                    maxLength: 63
                    minLength: 1
                    type: string
                  promotion:
                    description: Promotion controls how changes move into this environment.
                    type: string
                required:
                - name
                type: object
              type: array
            memory:
              description: |-
                Memory stores durable context the AI should consider for this
                project. It is edited explicitly through the API in the MVP.
              properties:
                constraints:
                  items:
                    type: string
                  type: array
                goals:
                  items:
                    type: string
                  type: array
                requirements:
                  items:
                    type: string
                  type: array
              type: object
            repository:
              description: Repository records the Code provider repository backing
                this Project.
              properties:
                connectionRef:
                  description: ConnectionRef names the Code provider Connection used
                    by the Repository.
                  maxLength: 253
                  type: string
                name:
                  description: Name is the repository name on the git host.
                  maxLength: 253
                  type: string
                repositoryRef:
                  description: RepositoryRef names the Repository resource in the
                    same workspace.
                  maxLength: 253
                  minLength: 1
                  type: string
              required:
              - repositoryRef
              type: object
            sharing:
              description: |-
                Sharing captures App Studio access policy intent for previews and
                published apps. Empty policies are interpreted as private.
              properties:
                preview:
                  description: |-
                    Preview controls who may access the mutable development preview. The
                    current implementation enforces private access; shared/public are future
                    policy intent.
                  properties:
                    mode:
                      description: Mode is the requested visibility for this channel.
                        Empty means private.
                      enum:
                      - private
                      - shared
                      - public
                      type: string
                  type: object
                publishing:
                  description: |-
                    Publishing controls who may access published app instances once the
                    publishing runtime exists.
                  properties:
                    mode:
                      description: Mode is the requested visibility for this channel.
                        Empty means private.
                      enum:
                      - private
                      - shared
                      - public
                      type: string
                  type: object
              type: object
            template:
              description: |-
                Template names the infrastructure Template whose instance backs this
                Project's development environment (docs/app-studio-template-sandboxes.md).
                When set, the development binding is generated from the Template's
                instanceCRD with kedgeMode: development, and file sync routes per the
                Template's declared development components. Empty means the project has
                no development environment yet — one must be selected before any
                development runtime surface (sync, preview, logs) works.
              properties:
                name:
                  description: Name is the Template's catalog name (e.g. "application").
                  maxLength: 253
                  minLength: 1
                  type: string
              required:
              - name
              type: object
          required:
          - displayName
          type: object
        status:
          description: ProjectStatus defines the observed Project state.
          properties:
            environments:
              description: Environments reports provider-observed environment state.
              items:
                properties:
                  bindings:
                    items:
                      properties:
                        name:
                          type: string
                        outputs:
                          additionalProperties:
                            type: string
                          type: object
                        phase:
                          type: string
                        previewURL:
                          type: string
                        provider:
                          type: string
                        url:
                          type: string
                      type: object
                    type: array
                  mode:
                    type: string
                  name:
                    type: string
                  phase:
                    type: string
                type: object
              type: array
            phase:
              description: Phase is Ready for MVP-created Projects.
              type: string
            updatedAt:
              description: UpdatedAt reflects the latest API mutation affecting metadata
                or memory.
              format: date-time
              type: string
          type: object
      type: object
    served: true
    storage: true
    subresources:
      status: {}