PAS Code Glossary

This page defines the terms used in the Control Hub and its documentation. The terms are listed alphabetically. Each entry includes a brief definition and a link to the page where you can find more information on the topic.

Term

Description

Further Information

Active Platform

The platform connection that the PAS CLI currently works against. Exactly one stored connection is active at a time.

Agent

A feature of a service component. An AI agent that answers questions and performs tasks on the platform. It is reached through the service that provides it and therefore has no endpoint of its own.

AI Coding Assistant

The assistant that you use in your editor. Every project created with pas new is prepared for it and receives the skills that PAS Code ships.

Developing With an AI Coding Assistant

App

A component type. A web frontend that users open in the browser.

Key Concepts

Approval Gate

The end of a phase of the development workflow. The result is presented to you, and the workflow advances only after you approve it explicitly.

Working With Skills

Bundle

A group of components that are deployed together. A bundle is a package of the project and lists its components in a bundle.json.

Cluster Development

Running the project on a Kubernetes cluster with pas start --profile <profile>. Use it when you need conditions close to the platform.

What is the PAS CLI?

Component

A part of a project. A component is a service or an app. A service can additionally provide one or more agents.

Key Concepts

Component Default

The baseline values of a component, built into its image. They apply wherever no other source sets a value.

Key Concepts

Component Deployment

The running instance of a single component inside a project deployment. It has its own status, type, endpoint, and configuration.

Working With the Deployment Detail Page

Component Deployment Detail View

The right-hand view of the deployment detail page. It shows the status, the type, the endpoint, and the configuration of the selected component deployment.

Working With the Deployment Detail Page

Component-Level Configuration

The configuration values of a single component. You author them in the configuration file of that component.

Configuring a Deployment

Configuration

The runtime settings of a deployment, stored as JSON. Configuration exists at project level and at component level.

Configuring a Deployment

Configuration Editor

The editor in which you view and change the configuration of a deployment.

Configuring a Deployment

Content Area

The part of the interface to the right of the sidebar. It displays the current view and changes as you navigate.

Working With the Control Hub

Control Hub

The web application in which you deploy and operate the projects that are published on the platform.

Conversation

All messages you have exchanged with the AI assistant since you last started a new conversation.

Ask the Platform Assistant!

Default Bundle

The implicit bundle of a project that defines no bundle of its own. It contains all components of the project.

Key Concepts

Deployment

A running instance of a PAS project in an environment. Each deployment has its own name and its own configuration.

Deployment Configuration

The runtime settings that a project ships. You author them as files in your project, and they are published with the version.

Deployment Detail Page

The page on which you monitor and manage a single deployment. It consists of the deployment panel and the component deployment detail view.

Working With the Deployment Detail Page

Deployment Name

The name that identifies a deployment. It must be unique within an environment.

Deploying a Project

Deployment Panel

The left-hand panel of the deployment detail page. It identifies the project deployment, holds its actions, and lists its components.

Working With the Deployment Detail Page

Deployments View

The landing page of the Control Hub. It lists the deployments running across your environments and is where you monitor and manage them.

Working With the Deployments View

Endpoint

The address at which a running component can be reached. A component that has no endpoint shows a dash instead of a link. An agent has no endpoint of its own.

Working With the Deployment Detail Page

Environment

The target a project is deployed to. Environments keep deployments separate from one another, for example a development and a production environment.

Key Concepts

Legacy Standalone Service

A deployed service that is not part of a project. It carries a Legacy badge and cannot be managed from the Control Hub.

Control Hub Status and Badge Reference

Local Development

Running the project on your own computer with pas start. The fastest way to see a change. A local run is not a deployment.

What is the PAS CLI?

Logout

The sidebar option that ends your session and returns you to the sign-in page.

Getting Started With the Control Hub

Merge

The default strategy for the configuration values an operator sets on a deployment. It keeps a shipped value wherever the operator sets no value.

Configuring a Deployment

Multiple

The status of a project deployment whose component deployments are currently in different states, for example some started and some stopped.

Control Hub Status and Badge Reference

Navigation Header

The bar above the content area. It holds the back button and the Ask Assistant button, which opens the AI assistant.

Working With the Control Hub

PAS CLI

The command line tool that developers call through pas to create, develop, and run PAS Code projects. It is the only supported way to create a project and its components.

PAS Code

The solution that covers scaffolding, development, testing, deployment, and operation of software for the Scheer PAS platform in a single workflow.

Getting Started With PAS Code

PAS Resource Monitor

The separate application in which the logs of a project or component deployment are displayed. The Control Hub links to it and does not display logs itself.

Inspecting Logs

Pipeline

The platform process that a push starts. It builds the components of the project, creates a version, publishes the images and the configuration, and registers the version with the platform.

Platform

A Scheer PAS installation. It hosts the Git repositories of your projects, builds and publishes your projects, and runs your deployments.

Key Concepts

Platform Assistant

The name of the AI assistant of the Control Hub.

Ask the Platform Assistant!

Platform Connection

The stored connection between your computer and one platform. You can store more than one connection, and you activate one of them.

Precedence

The order in which a configuration value wins when more than one source sets it. A component default is overridden by a referenced value, and a referenced value is overridden by a value set directly in the configuration.

Key Concepts

Profile

A named Kubernetes cluster target, stored as a JSON file in  ~/.pas/profiles and used by cluster development.

Commands

Project

A versioned, deployable unit made of one or more components. Definition of a PAS project.

Published projects appear in the Projects Catalog.

Project Deployment

A running instance of a project in an environment, with its own name and its own configuration. It contains one component deployment per component of the project.

Project-Level Configuration

The configuration values that apply to the whole deployment and that its components share. You author them in the configuration file of the bundle.

Configuring a Deployment

Projects Catalog

The view in which you browse the published projects and their versions, and from which you deploy them.

Working With the Projects Catalog

Push

The handover of your project from your computer to the platform. A push starts the pipeline.

Developing with PAS Code: From Initial Setup to First Push

Quick Actions

The actions in the last column of a row in the Deployments table, for example start, stop, delete, and open logs.

Working With the Deployments View

Readme

The description of a project written by its author. It is displayed on the Readme tab of the project detail view.

Inspecting the Project Details

Reference

A pointer to a configuration value instead of a copy of the value: to a project-level value by name, or to a secret kept in the cluster. The platform resolves a reference when the project is deployed.

Repository

The Git repository of your project on the platform. pas new creates it on request, and pas platform git manages your access to it.

Commands

Rules

The code, specification, and documentation rules that the skills apply. A project completes or overrides them in its .agents folder.

Secret

A configuration value that is kept in the cluster and used through a reference. A referenced secret appears neither in your sources nor in the published images.

Key Concepts

Service

A component type. A component that provides functions and data to apps and to other services.

Key Concepts

Sidebar

The panel on the left of the window. It holds your identity, the navigation between the two views, and the Logout button.

Working With the Control Hub

Skill

A packaged instruction set that your AI coding assistant loads when it recognizes a matching task. A skill names the PAS CLI command to call, the options that apply, and the rules to follow.

Skills

Skill Source

A location that a project declares its skills from, for example an installed package or a local folder.

Skills

Spec-Driven Development

The fixed order that every change follows: specification, then code, then documentation. Each phase ends with an approval gate.

Working With Skills

Specification

A SPEC.md file that describes what the code must achieve. It sits next to the code it governs and applies to its own directory and to the subdirectories of that directory.

Working With Skills

Status

The state of a project or component deployment: Started, Starting, Stopped, Multiple, or Failed.

Control Hub Status and Badge Reference

Type

The classification of a component: service, or app.

Key Concepts

Version

The result of publishing a project. Each time a project is published, it becomes a new version. You select the version when you deploy.

Key Concepts

📗