diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 4c7282d..63f854d 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,7 +1,7 @@ { "name": "Managed-Apps", "metadata": { - "description": "Microsoft Managed Apps plugin marketplace β€” wraps the @microsoft/managed-apps-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).", + "description": "Copilot Managed Runtime plugin marketplace β€” wraps the @microsoft/cmr-cli (ms) toolchain for coding agents (GitHub Copilot CLI, Claude Code).", "version": "0.1.0" }, "owner": { @@ -12,8 +12,8 @@ { "name": "microsoft-managed-apps", "source": "./plugins/microsoft-managed-apps", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", - "version": "2.1.8" + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/cmr-cli (ms) toolchain.", + "version": "2.1.10" } ] } diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index ff30f19..8d0f084 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -1,6 +1,6 @@ --- name: "🐞 Bug Report" -about: "Report a bug with Microsoft Managed Apps" +about: "Report a bug with Copilot Managed Runtime" title: "[Bug] " labels: bug --- diff --git a/README.md b/README.md index f143265..f630a1d 100644 --- a/README.md +++ b/README.md @@ -5,13 +5,13 @@ Copilot Managed Runtime hosts Microsoft 365 line-of-business applications that automatically inherit organizational governance, security, and compliance controls from the moment they're created. -This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft/managed-apps` scope: +This repository hosts the official first-party project **templates** and is the home for **public issues**. The tooling itself ships as npm packages under the `@microsoft` scope: | Package | Description | | --- | --- | -| [`@microsoft/managed-apps`](https://www.npmjs.com/package/@microsoft/managed-apps) | SDK for building apps hosted on Copilot Managed Runtime | -| [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime | -| [`@microsoft/managed-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/managed-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-apps`](https://www.npmjs.com/package/@microsoft/cmr-apps) | SDK for building apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-cli`](https://www.npmjs.com/package/@microsoft/cmr-cli) | Command-line interface for building and managing apps hosted on Copilot Managed Runtime | +| [`@microsoft/cmr-apps-vite-plugin`](https://www.npmjs.com/package/@microsoft/cmr-apps-vite-plugin) | Vite plugin for apps hosted on Copilot Managed Runtime | ## Getting started diff --git a/SUPPORT.md b/SUPPORT.md index 1efe5a6..7299af6 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -2,13 +2,13 @@ ## How to file issues and get help -Microsoft Managed Apps uses GitHub Issues to track bugs. Please search the existing issues before +Copilot Managed Runtime uses GitHub Issues to track bugs. Please search the existing issues before filing new issues to avoid duplicates. For new issues, file your bug as a new Issue in this repository. -For how-to questions and product guidance, see the [Microsoft Managed Apps documentation](https://go.microsoft.com/fwlink/?LinkId=2369054). +For how-to questions and product guidance, see the [Copilot Managed Runtime documentation](https://go.microsoft.com/fwlink/?LinkId=2369054). ## Microsoft Support Policy -Microsoft Managed Apps is currently in **public preview**. Support is limited to the resources +Copilot Managed Runtime is currently in **public preview**. Support is limited to the resources listed above. diff --git a/github-actions/AGENTS.md b/github-actions/AGENTS.md index 11a6286..a837cfa 100644 --- a/github-actions/AGENTS.md +++ b/github-actions/AGENTS.md @@ -1,8 +1,8 @@ # Agent guide β€” github-actions This directory holds the **`install-ms-cli`**, **`ms-app-pack`**, and -**`ms-app-deploy`** GitHub Actions for building and deploying Microsoft Managed -Apps from CI. +**`ms-app-deploy`** GitHub Actions for building and deploying apps on Copilot Managed Runtime +from CI. If you're an agent (GitHub Copilot CLI, Claude Code, or any other) helping with this component, the reusable skills below are plain Markdown runbooks β€” read the diff --git a/github-actions/CHANGELOG.md b/github-actions/CHANGELOG.md index bbf3b20..7b05f48 100644 --- a/github-actions/CHANGELOG.md +++ b/github-actions/CHANGELOG.md @@ -1,6 +1,6 @@ # Changelog -All notable changes to the Managed Apps GitHub Actions (under `github-actions/`) +All notable changes to the Copilot Managed Runtime GitHub Actions (under `github-actions/`) are documented here. This project follows [Semantic Versioning](https://semver.org) and the format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). @@ -12,10 +12,10 @@ the new version **in the same PR that bumps the version**, before it merges to ## [1.0.1] - 2026-06-22 -Initial release of the Managed Apps GitHub Actions. +Initial release of the Copilot Managed Runtime GitHub Actions. ### Added -- `install-ms-cli` β€” installs `@microsoft/managed-apps-cli` (binary: `ms`) on the +- `install-ms-cli` β€” installs `@microsoft/cmr-cli` (binary: `ms`) on the runner. Supports the public npm registry and private Azure DevOps Artifacts feeds (`_password`/PAT vs. bearer `_authToken`, chosen by strict hostname match). - `ms-app-pack` β€” runs `ms app pack` to build the app and stage the packed artifact. diff --git a/github-actions/README.md b/github-actions/README.md index 884d0d2..d2cf183 100644 --- a/github-actions/README.md +++ b/github-actions/README.md @@ -1,12 +1,12 @@ -# Managed Apps GitHub Actions +# Copilot Managed Runtime GitHub Actions -GitHub Actions for building and deploying [Microsoft Managed Apps](https://www.npmjs.com/package/@microsoft/managed-apps-cli) from CI. +GitHub Actions for building and deploying apps on [Copilot Managed Runtime](https://www.npmjs.com/package/@microsoft/cmr-cli) from CI. ## Actions | Action | What it does | Ref | |---|---|---| -| [`install-ms-cli`](./install-ms-cli) | Installs `@microsoft/managed-apps-cli` (binary: `ms`) on the runner. | `microsoft/Managed-Apps/github-actions/install-ms-cli@v1` | +| [`install-ms-cli`](./install-ms-cli) | Installs `@microsoft/cmr-cli` (binary: `ms`) on the runner. | `microsoft/Managed-Apps/github-actions/install-ms-cli@v1` | | [`ms-app-pack`](./ms-app-pack) | Runs `ms app pack` β€” builds and packs the app into a deployable artifact. | `microsoft/Managed-Apps/github-actions/ms-app-pack@v1` | | [`ms-app-deploy`](./ms-app-deploy) | Runs `ms app deploy` β€” uploads the artifact and deploys to the target environment. | `microsoft/Managed-Apps/github-actions/ms-app-deploy@v1` | @@ -53,7 +53,7 @@ See each action's `action.yml` for the full input/output reference. Step-by-step guides any operator β€” or coding-agent CLI (GitHub Copilot CLI, Claude Code, etc.) β€” can follow. See [`AGENTS.md`](AGENTS.md) for the index. -- [Architecture & Flow](agent-skills/architecture.md) β€” the end-to-end managed apps lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams. +- [Architecture & Flow](agent-skills/architecture.md) β€” the end-to-end Copilot Managed Runtime lifecycle (setup, local dev, CI loops), the `ms-app-deploy` sequence with service rejection points, and the release/versioning flow, with diagrams. - [Release guide](agent-skills/release-guide.md) β€” how to cut a release PR (version bump + changelog + dist rebuild). ## Prerequisites diff --git a/github-actions/agent-skills/architecture.md b/github-actions/agent-skills/architecture.md index 3fe34da..bb147dd 100644 --- a/github-actions/agent-skills/architecture.md +++ b/github-actions/agent-skills/architecture.md @@ -1,6 +1,6 @@ -# Managed Apps GitHub Actions β€” Architecture & Flow +# Copilot Managed Runtime GitHub Actions β€” Architecture & Flow -How the actions under `github-actions/` fit into the end-to-end managed apps lifecycle: +How the actions under `github-actions/` fit into the end-to-end Copilot Managed Runtime lifecycle: one-time app setup, the local dev loop, the CI/CD deploy loop, and how this repo releases the actions themselves. Diagrams are Mermaid (render on GitHub). @@ -8,7 +8,7 @@ releases the actions themselves. Diagrams are Mermaid (render on GitHub). | Piece | Role | |---|---| -| `ms` CLI (`@microsoft/managed-apps-cli`) | Does the real work: scaffolds, builds, packs, uploads, deploys, shares. | +| `ms` CLI (`@microsoft/cmr-cli`) | Does the real work: scaffolds, builds, packs, uploads, deploys, shares. | | `install-ms-cli` action | Installs the `ms` CLI on the runner. | | `ms-app-pack` action | Wraps `ms app pack` (build + stage artifact). Optional β€” deploy can pack internally. | | `ms-app-deploy` action | Wraps `ms app deploy` (build + pack + upload + deploy). | @@ -63,7 +63,7 @@ sequenceDiagram participant WF as Workflow participant ACT as ms-app-deploy participant CLI as ms CLI - participant RP as Managed Apps service + participant RP as Copilot Managed Runtime service WF->>ACT: with working-directory, app-id, client-secret, tenant-id ACT->>ACT: require MS_MANAGED_APPS_INSTALLED == true @@ -127,7 +127,7 @@ flowchart LR - **Auth:** interactive sign-in (`ms auth login`) works for local dev. For CI, supply all three Service Principal inputs (`app-id`, `client-secret`, `tenant-id`) β€” the actions set `MS_CLI_USE_SP_AUTH` + `MS_CLI_SP_*`, and the service - accepts the SPN for managed apps operations, so the deploy runs with no developer in + accepts the SPN for Copilot Managed Runtime operations, so the deploy runs with no developer in the loop. - **Sharing:** for `repoType: none` apps (no platform-managed repo), `ms app share --access edit` grants contributor access at the **app scope** diff --git a/github-actions/dist/actions/install-ms-cli/index.js b/github-actions/dist/actions/install-ms-cli/index.js index 64ad579..84143f2 100644 --- a/github-actions/dist/actions/install-ms-cli/index.js +++ b/github-actions/dist/actions/install-ms-cli/index.js @@ -19836,7 +19836,7 @@ async function main() { const version = core.getInput(argName.version, { required: false }) || "latest"; const registryUrl = core.getInput(argName.registryUrl, { required: false }) || "https://registry.npmjs.org"; const registryAuthToken = core.getInput(argName.registryAuthToken, { required: false }); - const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || "@microsoft/managed-apps-cli"; + const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || "@microsoft/cmr-cli"; if (registryAuthToken) { core.setSecret(registryAuthToken); } diff --git a/github-actions/install-ms-cli/action.yml b/github-actions/install-ms-cli/action.yml index fabe0df..9c7e72e 100644 --- a/github-actions/install-ms-cli/action.yml +++ b/github-actions/install-ms-cli/action.yml @@ -3,10 +3,10 @@ # # install-ms-cli/action.yml # -# Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner. +# Installs the Copilot Managed Runtime `ms` CLI (@microsoft/cmr-cli) on the GitHub Actions runner. # -# Defaults to the public npm registry β€” @microsoft/managed-apps-cli is published there -# (since 2026-05-14). No inputs are required for standard usage: +# Defaults to @microsoft/cmr-cli on the public npm registry. Standard usage +# requires the renamed package to be published there: # # - uses: microsoft/Managed-Apps/github-actions/install-ms-cli@v1 # @@ -20,12 +20,12 @@ # registry-auth-token: ${{ secrets.AZURE_DEVOPS_PAT }} # name: 'install-ms-cli' -description: 'Install the Microsoft managed apps CLI (@microsoft/managed-apps-cli, binary: ms)' +description: 'Install the Copilot Managed Runtime CLI (@microsoft/cmr-cli, binary: ms)' inputs: version: description: > - Version of @microsoft/managed-apps-cli to install. Use 'latest' or a specific + Version of @microsoft/cmr-cli to install. Use 'latest' or a specific semver / dev tag. Defaults to 'latest'. required: false default: 'latest' @@ -47,10 +47,10 @@ inputs: npm-package-name: description: > - npm package to install. Defaults to @microsoft/managed-apps-cli, which provides + npm package to install. Defaults to @microsoft/cmr-cli, which provides the `ms` binary. Override only for testing alternate builds. required: false - default: '@microsoft/managed-apps-cli' + default: '@microsoft/cmr-cli' outputs: cli-version: diff --git a/github-actions/ms-app-deploy/action.yml b/github-actions/ms-app-deploy/action.yml index b1ef2c0..ec206a6 100644 --- a/github-actions/ms-app-deploy/action.yml +++ b/github-actions/ms-app-deploy/action.yml @@ -3,7 +3,7 @@ # # ms-app-deploy/action.yml # -# Deploys a Microsoft managed apps code app via `ms app deploy`. Three deploy modes are +# Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three deploy modes are # supported, selected based on inputs and the app's repoType from # ms.config.json: # @@ -18,7 +18,7 @@ # 3. repoType:'native' / 'github' β†’ `ms app deploy --commit ` # Server-side build for the commit, then deploy. # -# Requires @microsoft/managed-apps-cli >= 0.7.0 for `--artifact` support. +# Requires @microsoft/cmr-cli >= 0.7.0 for `--artifact` support. # # The action reads `appId`, `environmentId`, and `repoType` from # ms.config.json (written by `ms app create`). @@ -35,7 +35,7 @@ # Service Principal auth: # The auth inputs (`app-id`, `client-secret`, `tenant-id`) are wired to the # CLI's SPN env vars (MS_CLI_SP_* + MS_CLI_USE_SP_AUTH). The service -# accepts Service Principal identities for managed apps operations. Provide all three +# accepts Service Principal identities for Copilot Managed Runtime operations. Provide all three # inputs together to deploy as the SPN with no developer in the loop. # --------------------------------------------------------------------------- # @@ -74,7 +74,7 @@ # tenant-id: ${{ secrets.PP_SP_TENANT_ID }} # name: 'ms-app-deploy' -description: 'Deploy a Microsoft managed apps code app for the given commit' +description: 'Deploy a Copilot Managed Runtime code app for the given commit' inputs: # ── App context ─────────────────────────────────────────────────────────── @@ -98,7 +98,7 @@ inputs: cloud: description: > Cloud instance to target. One of: prod, test, preview, - gccmoderate, dev. The managed apps end-to-end flow is currently supported only + gccmoderate, dev. The Copilot Managed Runtime end-to-end flow is currently supported only in 'test'. Maps to MS_CLI_CLOUD_INSTANCE. required: false default: 'test' diff --git a/github-actions/ms-app-pack/action.yml b/github-actions/ms-app-pack/action.yml index 3eec30d..6a5968f 100644 --- a/github-actions/ms-app-pack/action.yml +++ b/github-actions/ms-app-pack/action.yml @@ -3,14 +3,14 @@ # # ms-app-pack/action.yml # -# Packs a Microsoft managed apps code app into a deployable artifact by invoking `ms app pack`. +# Packs a Copilot Managed Runtime code app into a deployable artifact by invoking `ms app pack`. # Pack runs the `buildCommand` from ms.config.json (default `npm run build`) # and copies the build output to the canonical packed layout at # /.ms/packed/apps//client/ # # After pack, `ms-app-deploy` picks up the artifact automatically. # -# This action is a transitional step. The managed apps CLI is adding a `--artifact` +# This action is a transitional step. The Copilot Managed Runtime CLI is adding a `--artifact` # flag to `ms app deploy` that will fold pack into deploy for repoType:'none' # apps. Once that ships, you can drop the `- uses: ms-app-pack` step from # your workflow. @@ -43,7 +43,7 @@ # tenant-id: ${{ secrets.PP_SP_TENANT_ID }} # name: 'ms-app-pack' -description: 'Build and pack a Microsoft managed apps code app into a deployable artifact' +description: 'Build and pack a Copilot Managed Runtime code app into a deployable artifact' inputs: working-directory: diff --git a/github-actions/package-lock.json b/github-actions/package-lock.json index 3944b4b..4298bd6 100644 --- a/github-actions/package-lock.json +++ b/github-actions/package-lock.json @@ -1,11 +1,11 @@ { - "name": "@microsoft/managed-apps-github-actions", + "name": "@microsoft/cmr-apps-github-actions", "version": "1.0.1", "lockfileVersion": 3, "requires": true, "packages": { "": { - "name": "@microsoft/managed-apps-github-actions", + "name": "@microsoft/cmr-apps-github-actions", "version": "1.0.1", "license": "MIT", "dependencies": { diff --git a/github-actions/package.json b/github-actions/package.json index d6ba915..9657903 100644 --- a/github-actions/package.json +++ b/github-actions/package.json @@ -1,8 +1,8 @@ { - "name": "@microsoft/managed-apps-github-actions", + "name": "@microsoft/cmr-apps-github-actions", "version": "1.0.1", "private": true, - "description": "GitHub Actions for building and deploying Microsoft Managed Apps from CI", + "description": "GitHub Actions for building and deploying apps on Copilot Managed Runtime from CI", "main": "index.js", "scripts": { "clean": "node node_modules/gulp/bin/gulp.js clean", diff --git a/github-actions/src/actions/install-ms-cli/index.ts b/github-actions/src/actions/install-ms-cli/index.ts index d994f35..11dcc30 100644 --- a/github-actions/src/actions/install-ms-cli/index.ts +++ b/github-actions/src/actions/install-ms-cli/index.ts @@ -3,7 +3,7 @@ // src/actions/install-ms-cli/index.ts // -// Installs the managed apps `ms` CLI (@microsoft/managed-apps-cli) on the GitHub Actions runner +// Installs the Copilot Managed Runtime `ms` CLI (@microsoft/cmr-cli) on the GitHub Actions runner // via npm. The package's `bin` field maps to the `ms` executable. import * as core from '@actions/core'; @@ -40,7 +40,7 @@ export async function main(): Promise { const version = core.getInput(argName.version, { required: false }) || 'latest'; const registryUrl = core.getInput(argName.registryUrl, { required: false }) || 'https://registry.npmjs.org'; const registryAuthToken = core.getInput(argName.registryAuthToken, { required: false }); - const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || '@microsoft/managed-apps-cli'; + const npmPackageName = core.getInput(argName.npmPackageName, { required: false }) || '@microsoft/cmr-cli'; // Mask the auth token so it never appears in logs if (registryAuthToken) { diff --git a/github-actions/src/actions/ms-app-deploy/index.ts b/github-actions/src/actions/ms-app-deploy/index.ts index 1594c13..fd85b5e 100644 --- a/github-actions/src/actions/ms-app-deploy/index.ts +++ b/github-actions/src/actions/ms-app-deploy/index.ts @@ -3,7 +3,7 @@ // src/actions/ms-app-deploy/index.ts // -// Deploys a Microsoft managed apps code app via `ms app deploy`. Three modes: +// Deploys a Copilot Managed Runtime code app via `ms app deploy`. Three modes: // // 1. repoType:'none' + artifact-path supplied β†’ --artifact // Uploads a pre-built zip and deploys it. @@ -12,7 +12,7 @@ // 3. repoType:'native'/'github' β†’ --commit // Server-side build for the commit, then deploy. // -// Requires @microsoft/managed-apps-cli >= 0.7.0 for --artifact support. +// Requires @microsoft/cmr-cli >= 0.7.0 for --artifact support. // // Reads `appId`, `environmentId`, `repoType` from ms.config.json (written // by `ms app create`). diff --git a/github-actions/src/actions/ms-app-pack/index.ts b/github-actions/src/actions/ms-app-pack/index.ts index dc51ce6..b75534f 100644 --- a/github-actions/src/actions/ms-app-pack/index.ts +++ b/github-actions/src/actions/ms-app-pack/index.ts @@ -3,7 +3,7 @@ // src/actions/ms-app-pack/index.ts // -// Packs a Microsoft managed apps code app via `ms app pack`. Pack runs the `buildCommand` from +// Packs a Copilot Managed Runtime code app via `ms app pack`. Pack runs the `buildCommand` from // ms.config.json (default: `npm run build`) and copies the result into the // canonical packed layout `/.ms/packed/apps//client/`. // diff --git a/plugins/microsoft-managed-apps/.claude-plugin/plugin.json b/plugins/microsoft-managed-apps/.claude-plugin/plugin.json index 1d8aa1d..b042afb 100644 --- a/plugins/microsoft-managed-apps/.claude-plugin/plugin.json +++ b/plugins/microsoft-managed-apps/.claude-plugin/plugin.json @@ -1,12 +1,12 @@ { "name": "microsoft-managed-apps", - "version": "2.1.8", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", + "version": "2.1.10", + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/cmr-cli (ms) toolchain.", "author": { "name": "Microsoft", "url": "https://github.com/microsoft/Managed-Apps" }, - "homepage": "https://www.npmjs.com/package/@microsoft/managed-apps-cli", + "homepage": "https://www.npmjs.com/package/@microsoft/cmr-cli", "repository": "https://github.com/microsoft/Managed-Apps", "license": "MIT", "keywords": [ diff --git a/plugins/microsoft-managed-apps/AGENTS.md b/plugins/microsoft-managed-apps/AGENTS.md index ec51b67..80be25e 100644 --- a/plugins/microsoft-managed-apps/AGENTS.md +++ b/plugins/microsoft-managed-apps/AGENTS.md @@ -1,10 +1,10 @@ -# Microsoft Managed Apps Plugin β€” Development Guidelines +# Copilot Managed Runtime Plugin β€” Development Guidelines -This file provides instructions for assistants working on the managed apps plugin itself (not for end-users of the plugin). +This file provides instructions for assistants working on the Copilot Managed Runtime plugin itself (not for end-users of the plugin). ## Overview -The managed apps plugin wraps `@microsoft/managed-apps-cli` (binary `ms`) to scaffold, develop, and ship managed apps end-to-end. It provides skills for: +The Copilot Managed Runtime plugin wraps `@microsoft/cmr-cli` (binary `ms`) to scaffold, develop, and ship apps on Copilot Managed Runtime end-to-end. It provides skills for: - Creating a new app (`/create-app`) β€” global install of the CLI, scaffold, local dev loop. - Iterating locally (`/dev`) β€” `ms app dev`, hot reload against the App Player. diff --git a/plugins/microsoft-managed-apps/QUICKSTART.md b/plugins/microsoft-managed-apps/QUICKSTART.md index 1576e73..35a22b4 100644 --- a/plugins/microsoft-managed-apps/QUICKSTART.md +++ b/plugins/microsoft-managed-apps/QUICKSTART.md @@ -1,6 +1,6 @@ # Quick Start Guide -Build and run a Microsoft App using just your coding copilot. No prior managed apps knowledge needed. +Build and run a Microsoft App using just your coding copilot. No prior Copilot Managed Runtime knowledge needed. --- @@ -15,7 +15,7 @@ node --version # should print v22.x.x or higher ``` **Git** -Managed apps store app code in a remote git repository, and `ms app create` initializes the local repo. Install from [git-scm.com](https://git-scm.com). Git for Windows includes Git Credential Manager, which the first `ms app create` will exercise. +Apps on Copilot Managed Runtime store app code in a remote git repository, and `ms app create` initializes the local repo. Install from [git-scm.com](https://git-scm.com). Git for Windows includes Git Credential Manager, which the first `ms app create` will exercise. That's it for now β€” `/create-app` installs the `ms` CLI itself globally on its first run. @@ -44,7 +44,7 @@ Navigate to an **empty** folder where you want your project. `/create-app` treat Your copilot will: -1. Install `@microsoft/managed-apps-cli@latest` globally (with your confirmation) from the public npm registry. +1. Install `@microsoft/cmr-cli@latest` globally (with your confirmation) from the public npm registry. 2. Ask you what you want to build, plain English. 3. Run `ms app create` to scaffold the project. 4. Start `ms app dev` so you can play the app locally in the App Player. diff --git a/plugins/microsoft-managed-apps/README.md b/plugins/microsoft-managed-apps/README.md index 78c488b..1725b9c 100644 --- a/plugins/microsoft-managed-apps/README.md +++ b/plugins/microsoft-managed-apps/README.md @@ -1,10 +1,10 @@ -# Microsoft Managed Apps Plugin `Preview` +# Copilot Managed Runtime Plugin `Preview` > **Preview** β€” this plugin is in preview and under active development. Behavior may change. -Copilot plugin for building **managed apps** using `@microsoft/managed-apps-cli` (binary `ms`), React, and Vite. Works with both Claude Code and GitHub Copilot. +Copilot plugin for building apps on **Copilot Managed Runtime** using `@microsoft/cmr-cli` (binary `ms`), React, and Vite. Works with both Claude Code and GitHub Copilot. -Managed apps run locally against the App Player with hot reload (`ms app dev`) and deploy to the cloud only when you choose to. +Apps on Copilot Managed Runtime run locally against the App Player with hot reload (`ms app dev`) and deploy to the cloud only when you choose to. ## What's Included @@ -35,9 +35,9 @@ definitions. - [Node.js v22+](https://nodejs.org/) - Git + Git Credential Manager - [Claude Code](https://code.claude.com/docs/en/getting-started) or [GitHub Copilot CLI](https://github.com/features/copilot/cli/) -- Access to a managed apps-enabled tenant. The `@microsoft/managed-apps-cli` package is published on the public npm registry: [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli). +- Access to a Copilot Managed Runtime-enabled tenant and an available release of [`@microsoft/cmr-cli`](https://www.npmjs.com/package/@microsoft/cmr-cli) on the public npm registry. -The `/create-app` skill handles the global install of `@microsoft/managed-apps-cli@latest` on its own β€” you don't need to set that up by hand. +The `/create-app` skill handles the global install of `@microsoft/cmr-cli@latest` on its own β€” you don't need to set that up by hand. ## Install the plugin @@ -238,7 +238,7 @@ Describe the app in the command and the skill generates its name, plans the comp ## Telemetry -This plugin marks commands that invoke `@microsoft/managed-apps-cli` (`ms`) with `MS_CLI_ORIGIN=plugin`. +This plugin marks commands that invoke `@microsoft/cmr-cli` (`ms`) with `MS_CLI_ORIGIN=plugin`. The CLI uses this value as `cliSource`, the source of the command. The [Bash hook](hooks/pre-tool-use.sh) and [PowerShell hook](hooks/pre-tool-use.ps1) apply this default before tool execution. They preserve existing origin values, including empty values and inline assignments. @@ -282,5 +282,5 @@ To disable hooks, use the client's settings rather than editing only the shared ## Documentation -- [`@microsoft/managed-apps-cli` on npm](https://www.npmjs.com/package/@microsoft/managed-apps-cli) +- [`@microsoft/cmr-cli` on npm](https://www.npmjs.com/package/@microsoft/cmr-cli) - [Claude Code Plugins](https://code.claude.com/docs/en/plugins-reference) \ No newline at end of file diff --git a/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md b/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md index 134650c..3f9215d 100644 --- a/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md +++ b/plugins/microsoft-managed-apps/agents/microsoft-apps-architect.md @@ -1,13 +1,13 @@ --- name: microsoft-apps-architect -description: Managed apps Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. +description: Copilot Managed Runtime Architect specializing in React/Vite architecture, the @microsoft/cmr-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. --- **πŸ“‹ Shared Instructions: [shared-instructions.md](../shared/shared-instructions.md)** - Cross-cutting concerns (CLI install, env vars, planning, memory bank, execution style). -# Managed apps Architect +# Copilot Managed Runtime Architect -You are a managed apps Architect with deep expertise in building web apps on the managed apps platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). +You are a Copilot Managed Runtime Architect with deep expertise in building web apps on the Copilot Managed Runtime platform. Your toolchain is `@microsoft/cmr-cli` (binary `ms`). ## Execution Guardrails @@ -18,7 +18,7 @@ You are a managed apps Architect with deep expertise in building web apps on the ## Your Expertise - **React + Vite**: Component architecture, state management, TypeScript strict mode. -- **Managed apps platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. +- **Copilot Managed Runtime platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. - **Connector patterns**: Understanding all available connectors (Office 365 Outlook, Office 365 Users, Teams, SharePoint, OneDrive, Excel, Azure DevOps, Dataverse) and intelligently selecting them based on app requirements using the Connector Decision Guide. - **Connector Decision Guide** ([shared/connector-decision-guide.md](../shared/connector-decision-guide.md)): You must reference this guide when recommending connectors. Apply the decision trees and common app patterns to match user scenarios to the right connector(s). - **Shared connection policies** ([shared/allowed-actions.md](../shared/allowed-actions.md)): When a connection reference is shared (`sharedConnectionId` set in `ms.config.json`), the app must declare `allowedActions` or the deploy fails validation. Raise this while recommending a connector, not after β€” it shapes what the app is permitted to do at runtime. @@ -43,10 +43,10 @@ ms --version # Bin name has flipped between dev builds ``` - **Node.js below v22**: Report "Node.js 22+ is required. Upgrade or switch with `nvm use 22`." and STOP. -- **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/managed-apps-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. +- **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/cmr-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. - **All present**: Report versions and proceed. -## Key Considerations for managed apps +## Key Considerations for Copilot Managed Runtime ### App backend database @@ -58,7 +58,7 @@ and use [/add-backend](../skills/add-backend/SKILL.md). ### Connector-First Principle -**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Managed apps run in the App Player sandbox, which blocks arbitrary outbound HTTP. +**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Apps on Copilot Managed Runtime run in the App Player sandbox, which blocks arbitrary outbound HTTP. **When recommending connectors, always:** 1. Start with the user's app goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md b/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md index bb503b2..e803c3b 100644 --- a/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md +++ b/plugins/microsoft-managed-apps/com.github.copilot/agents/microsoft-apps-architect.agent.md @@ -1,13 +1,13 @@ --- name: microsoft-apps-architect -description: Managed apps Architect specializing in React/Vite architecture, the @microsoft/managed-apps-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. +description: Copilot Managed Runtime Architect specializing in React/Vite architecture, the @microsoft/cmr-cli (ms) toolchain, connector and data-source patterns, and local-dev-first iteration. Use when making architecture decisions, designing data models, selecting connectors, or troubleshooting `ms app create` / `ms app dev` / build issues. --- **πŸ“‹ Shared Instructions: [shared-instructions.md](../../shared/shared-instructions.md)** - Cross-cutting concerns (CLI install, env vars, planning, memory bank, execution style). -# Managed apps Architect +# Copilot Managed Runtime Architect -You are a managed apps Architect with deep expertise in building web apps on the managed apps platform. Your toolchain is `@microsoft/managed-apps-cli` (binary `ms`). +You are a Copilot Managed Runtime Architect with deep expertise in building web apps on the Copilot Managed Runtime platform. Your toolchain is `@microsoft/cmr-cli` (binary `ms`). ## Execution Guardrails @@ -18,7 +18,7 @@ You are a managed apps Architect with deep expertise in building web apps on the ## Your Expertise - **React + Vite**: Component architecture, state management, TypeScript strict mode. -- **Managed apps platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. +- **Copilot Managed Runtime platform**: How `ms app create` provisions app metadata + a remote git repository, how `ms app dev` runs a two-server local stack (dev + config) against the App Player, and how `ms app deploy` gets the app into the cloud. - **Connector patterns**: Understanding all available connectors (Office 365 Outlook, Office 365 Users, Teams, SharePoint, OneDrive, Excel, Azure DevOps, Dataverse) and intelligently selecting them based on app requirements using the Connector Decision Guide. - **Connector Decision Guide** ([shared/connector-decision-guide.md](../../shared/connector-decision-guide.md)): You must reference this guide when recommending connectors. Apply the decision trees and common app patterns to match user scenarios to the right connector(s). - **Shared connection policies** ([shared/allowed-actions.md](../../shared/allowed-actions.md)): When a connection reference is shared (`sharedConnectionId` set in `ms.config.json`), the app must declare `allowedActions` or the deploy fails validation. Raise this while recommending a connector, not after β€” it shapes what the app is permitted to do at runtime. @@ -43,10 +43,10 @@ ms --version # Bin name has flipped between dev builds ``` - **Node.js below v22**: Report "Node.js 22+ is required. Upgrade or switch with `nvm use 22`." and STOP. -- **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/managed-apps-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. +- **Missing `ms`**: Direct the user to `/create-app`, which installs `@microsoft/cmr-cli@latest` globally from the public npm registry. Never instruct them to `npm install --save-dev` per-workspace β€” install globally so the `ms` binary is on PATH and the workspace stays clean. - **All present**: Report versions and proceed. -## Key Considerations for managed apps +## Key Considerations for Copilot Managed Runtime ### App backend database @@ -58,7 +58,7 @@ and use [/add-backend](../../skills/add-backend/SKILL.md). ### Connector-First Principle -**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Managed apps run in the App Player sandbox, which blocks arbitrary outbound HTTP. +**For external integrations, use Power Platform connectors rather than raw HTTP calls.** Apps on Copilot Managed Runtime run in the App Player sandbox, which blocks arbitrary outbound HTTP. **When recommending connectors, always:** 1. Start with the user's app goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/hooks/pre-tool-use.ps1 b/plugins/microsoft-managed-apps/hooks/pre-tool-use.ps1 index 8769f4a..25af0c7 100644 --- a/plugins/microsoft-managed-apps/hooks/pre-tool-use.ps1 +++ b/plugins/microsoft-managed-apps/hooks/pre-tool-use.ps1 @@ -1,5 +1,5 @@ # PreToolUse hook (PowerShell): for any shell command that invokes the `ms` -# CLI (the @microsoft/managed-apps-cli binary), default MS_CLI_ORIGIN to `plugin`. +# CLI (the @microsoft/cmr-cli binary), default MS_CLI_ORIGIN to `plugin`. # Only the native Copilot entry point passes -GitHubCopilot to report # MS_PLUGIN_REPORT_AGENT=github-copilot. Shared hooks remove inherited reports. # @@ -42,13 +42,13 @@ function Write-AllowWithRewrite { $updated['command'] = $NewCommand $payload = @{ permissionDecision = 'allow' - permissionDecisionReason = 'Set plugin attribution for @microsoft/managed-apps-cli' + permissionDecisionReason = 'Set plugin attribution for @microsoft/cmr-cli' updatedInput = $updated modifiedArgs = $updated hookSpecificOutput = @{ hookEventName = 'PreToolUse' permissionDecision = 'allow' - permissionDecisionReason = 'Set plugin attribution for @microsoft/managed-apps-cli' + permissionDecisionReason = 'Set plugin attribution for @microsoft/cmr-cli' updatedInput = $updated } } diff --git a/plugins/microsoft-managed-apps/hooks/pre-tool-use.sh b/plugins/microsoft-managed-apps/hooks/pre-tool-use.sh index 2ce7def..a80d828 100644 --- a/plugins/microsoft-managed-apps/hooks/pre-tool-use.sh +++ b/plugins/microsoft-managed-apps/hooks/pre-tool-use.sh @@ -1,6 +1,6 @@ #!/usr/bin/env bash # PreToolUse hook: for any shell command that invokes the `ms` CLI (the -# @microsoft/managed-apps-cli binary), default MS_CLI_ORIGIN to `plugin`. +# @microsoft/cmr-cli binary), default MS_CLI_ORIGIN to `plugin`. # Only the native Copilot entry point passes --github-copilot to report # MS_PLUGIN_REPORT_AGENT=github-copilot. Shared hooks remove inherited reports. # @@ -140,7 +140,7 @@ else: updated = dict(tool_input) updated["command"] = prefix + command -reason = "Set plugin attribution for @microsoft/managed-apps-cli" +reason = "Set plugin attribution for @microsoft/cmr-cli" # Keep legacy fields, native Copilot modifiedArgs, and the Claude wrapper. print(json.dumps({ "permissionDecision": "allow", diff --git a/plugins/microsoft-managed-apps/hooks/session-start.ps1 b/plugins/microsoft-managed-apps/hooks/session-start.ps1 index 260ade5..0ce0098 100644 --- a/plugins/microsoft-managed-apps/hooks/session-start.ps1 +++ b/plugins/microsoft-managed-apps/hooks/session-start.ps1 @@ -1,9 +1,9 @@ -# SessionStart hook (PowerShell): inform the agent that the Microsoft Managed -# Apps plugin automatically attributes every `ms` CLI invocation via +# SessionStart hook (PowerShell): inform the agent that the Copilot Managed Runtime +# plugin automatically attributes every `ms` CLI invocation via # MS_CLI_ORIGIN. The PreToolUse hook enforces this transparently. $ErrorActionPreference = 'SilentlyContinue' -$msg = "[microsoft-managed-apps] The PreToolUse hook defaults MS_CLI_ORIGIN to plugin for commands that invoke the ms CLI (@microsoft/managed-apps-cli). It preserves existing origin values, including empty values and inline assignments. The native Copilot hook also sets MS_PLUGIN_REPORT_AGENT=github-copilot from its fixed entry point. Shared hooks remove inherited agent reports so the CLI can detect the agent. The plugin does not detect agents from environment markers. Do not add attribution variables yourself when hooks are active." +$msg = "[microsoft-managed-apps] The PreToolUse hook defaults MS_CLI_ORIGIN to plugin for commands that invoke the ms CLI (@microsoft/cmr-cli). It preserves existing origin values, including empty values and inline assignments. The native Copilot hook also sets MS_PLUGIN_REPORT_AGENT=github-copilot from its fixed entry point. Shared hooks remove inherited agent reports so the CLI can detect the agent. The plugin does not detect agents from environment markers. Do not add attribution variables yourself when hooks are active." # Skip re-emitting on compaction so the guidance isn't duplicated. try { diff --git a/plugins/microsoft-managed-apps/hooks/session-start.sh b/plugins/microsoft-managed-apps/hooks/session-start.sh index 0c09abf..b14cca2 100644 --- a/plugins/microsoft-managed-apps/hooks/session-start.sh +++ b/plugins/microsoft-managed-apps/hooks/session-start.sh @@ -1,11 +1,11 @@ #!/usr/bin/env bash -# SessionStart hook: inform the agent that the Microsoft Managed Apps plugin +# SessionStart hook: inform the agent that the Copilot Managed Runtime plugin # automatically attributes every `ms` CLI invocation via MS_CLI_ORIGIN. # The PreToolUse hook (pre-tool-use.sh) enforces this transparently β€” this # message just makes the behavior visible to the agent so it isn't surprised # when the executed command differs from what it requested. -export MSG="[microsoft-managed-apps] The PreToolUse hook defaults MS_CLI_ORIGIN to plugin for commands that invoke the ms CLI (@microsoft/managed-apps-cli). It preserves existing origin values, including empty values and inline assignments. The native Copilot hook also sets MS_PLUGIN_REPORT_AGENT=github-copilot from its fixed entry point. Shared hooks remove inherited agent reports so the CLI can detect the agent. The plugin does not detect agents from environment markers. Do not add attribution variables yourself when hooks are active." +export MSG="[microsoft-managed-apps] The PreToolUse hook defaults MS_CLI_ORIGIN to plugin for commands that invoke the ms CLI (@microsoft/cmr-cli). It preserves existing origin values, including empty values and inline assignments. The native Copilot hook also sets MS_PLUGIN_REPORT_AGENT=github-copilot from its fixed entry point. Shared hooks remove inherited agent reports so the CLI can detect the agent. The plugin does not detect agents from environment markers. Do not add attribution variables yourself when hooks are active." # Read hook stdin with a bounded single-line `read -t` (payloads are # single-line JSON) so the hook fails open quickly instead of blocking session diff --git a/plugins/microsoft-managed-apps/plugin.json b/plugins/microsoft-managed-apps/plugin.json index 6aa6426..3e85a81 100644 --- a/plugins/microsoft-managed-apps/plugin.json +++ b/plugins/microsoft-managed-apps/plugin.json @@ -1,13 +1,13 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "microsoft-managed-apps", - "version": "2.1.8", - "description": "[Preview] Create and manage Microsoft Managed Apps using the @microsoft/managed-apps-cli (ms) toolchain.", + "version": "2.1.10", + "description": "[Preview] Create and manage apps on Copilot Managed Runtime using the @microsoft/cmr-cli (ms) toolchain.", "author": { "name": "Microsoft", "url": "https://github.com/microsoft/Managed-Apps" }, - "homepage": "https://www.npmjs.com/package/@microsoft/managed-apps-cli", + "homepage": "https://www.npmjs.com/package/@microsoft/cmr-cli", "repository": "https://github.com/microsoft/Managed-Apps", "license": "MIT", "keywords": [ diff --git a/plugins/microsoft-managed-apps/shared/allowed-actions.md b/plugins/microsoft-managed-apps/shared/allowed-actions.md index 3636040..32b8537 100644 --- a/plugins/microsoft-managed-apps/shared/allowed-actions.md +++ b/plugins/microsoft-managed-apps/shared/allowed-actions.md @@ -36,8 +36,8 @@ ms.config.json ──► RP at deploy time ──► executionRestrictions p policy and allows or refuses it ``` -Enforcement lives in the **Connectors infrastructure**, not in the app and not in the managed -apps host. APIHub runs every connector request through the runtime policy and refuses anything +Enforcement lives in the **Connectors infrastructure**, not in the app and not in the Copilot +Managed Runtime host. APIHub runs every connector request through the runtime policy and refuses anything the policy doesn't permit. The host's part is only addressing: it rewrites the outgoing connector URL to point at the policy rather than the connection, and stamps an `x-ms-shared-connection-id` header. diff --git a/plugins/microsoft-managed-apps/shared/connector-decision-guide.md b/plugins/microsoft-managed-apps/shared/connector-decision-guide.md index ec512dd..a24ce9f 100644 --- a/plugins/microsoft-managed-apps/shared/connector-decision-guide.md +++ b/plugins/microsoft-managed-apps/shared/connector-decision-guide.md @@ -293,7 +293,7 @@ This skill handles ANY connector, including those not listed in this guide. When **This guide covers the most common cases, but `/add-data-source` works with any Microsoft connector β€” not just the commonly listed connectors above.** -### **For managed apps Architect Agent** +### **For Copilot Managed Runtime Architect Agent** When recommending connectors for an app design: 1. Always start with the user's end goal (not available connectors) diff --git a/plugins/microsoft-managed-apps/shared/development-standards.md b/plugins/microsoft-managed-apps/shared/development-standards.md index 2f58434..7119b7b 100644 --- a/plugins/microsoft-managed-apps/shared/development-standards.md +++ b/plugins/microsoft-managed-apps/shared/development-standards.md @@ -1,6 +1,6 @@ # Development Standards -Standards that apply to all managed apps skills. +Standards that apply to all Copilot Managed Runtime skills. ## Theme @@ -9,18 +9,18 @@ Standards that apply to all managed apps skills. ## Node.js -- **Node.js 22+ is required** β€” `@microsoft/managed-apps-cli` rejects older versions for codegen-bearing commands. +- **Node.js 22+ is required** β€” `@microsoft/cmr-cli` rejects older versions for codegen-bearing commands. - Check with `node --version` before starting. - If the user has multiple versions, suggest `nvm use 22`. ## CLI Install -- **Install `@microsoft/managed-apps-cli` globally**, never per-workspace, so the `ms` binary is on PATH and the per-app workspace stays clean. +- **Install `@microsoft/cmr-cli` globally**, never per-workspace, so the `ms` binary is on PATH and the per-app workspace stays clean. - Install command: ```bash - npm install -g @microsoft/managed-apps-cli@latest + npm install -g @microsoft/cmr-cli@latest ``` -- The CLI is published on the public npm registry: https://www.npmjs.com/package/@microsoft/managed-apps-cli +- Install from the public npm registry once the renamed CLI package is available: https://www.npmjs.com/package/@microsoft/cmr-cli - Pin to the `@latest` tag. - After install, probe the binary name (`ms` (single supported binary)). @@ -29,10 +29,10 @@ Standards that apply to all managed apps skills. Run this gate once per top-level workflow, before its first operational `ms` command. The `ms --version` probe is part of the gate: 1. Read the installed version with `ms --version`. -2. Read the latest stable version with `npm view @microsoft/managed-apps-cli@latest version`. +2. Read the latest stable version with `npm view @microsoft/cmr-cli@latest version`. 3. Compare the versions using semver rules. Do not treat an installed version newer than `@latest` as outdated. -4. If `@latest` is newer, tell the user both versions and ask: _"`@microsoft/managed-apps-cli` {installed} is installed, but {latest} is available. Update the global CLI before proceeding?"_ Wait for the answer. - - If approved, run `npm install -g @microsoft/managed-apps-cli@latest`, then verify `ms --version` reports the expected version before continuing. +4. If `@latest` is newer, tell the user both versions and ask: _"`@microsoft/cmr-cli` {installed} is installed, but {latest} is available. Update the global CLI before proceeding?"_ Wait for the answer. + - If approved, run `npm install -g @microsoft/cmr-cli@latest`, then verify `ms --version` reports the expected version before continuing. - If declined, acknowledge the choice and continue with the installed version for the rest of the workflow. 5. If the registry lookup fails, report that the latest version could not be checked and continue with the installed CLI. Do not silently claim it is current. @@ -42,7 +42,7 @@ The upgrade prompt satisfies the global-install confirmation requirement; do not ## Build & Deploy -- **Default loop is `ms app dev`**, not deploy. Managed apps run locally against the App Player with hot reload; deploy only when the user asks. +- **Default loop is `ms app dev`**, not deploy. Apps on Copilot Managed Runtime run locally against the App Player with hot reload; deploy only when the user asks. - When the user does want to ship: - Local-built (primary): `npm run build`, then `git add -A && git commit && git push`, then `ms app deploy`. - Cloud-built: `git add -A && git commit && git push`, then `ms app deploy [--commit ]`. diff --git a/plugins/microsoft-managed-apps/shared/shared-instructions.md b/plugins/microsoft-managed-apps/shared/shared-instructions.md index a3e377d..7f92f7d 100644 --- a/plugins/microsoft-managed-apps/shared/shared-instructions.md +++ b/plugins/microsoft-managed-apps/shared/shared-instructions.md @@ -1,6 +1,6 @@ # Shared Instructions -**This file aggregates all cross-cutting instructions that apply to every skill in the managed apps plugin.** +**This file aggregates all cross-cutting instructions that apply to every skill in the Copilot Managed Runtime plugin.** All skills reference this single file. When new shared instructions are added, update this file only β€” no changes needed to individual skills. @@ -37,7 +37,7 @@ Remove an inherited report so the CLI can detect the agent. - **Confirm before any deploy**: Before running `ms app deploy`, ask: _"Ready to deploy to [environment name]? This will update the live app."_ Wait for explicit user confirmation. There is no baseline-deploy exemption in this plugin β€” the default inner loop is `ms app dev`, not deploy. - **Sync git before deploy**: Before any `ms app deploy`, ensure current project changes are staged, committed, and pushed (`git add -A`, `git commit`, `git push`). Deploy only from a commit that exists on remote. -- **Confirm before any global install**: Before running `npm install -g ...` or `winget install ...`, ask: _"This will install [tool] globally on your machine. OK to proceed?"_ Wait for explicit user confirmation. This applies even when the install is a documented prerequisite. Exception: the `/create-app` skill's global install of `@microsoft/managed-apps-cli@latest` is part of the documented setup flow, but still surface the install command before running it. +- **Confirm before any global install**: Before running `npm install -g ...` or `winget install ...`, ask: _"This will install [tool] globally on your machine. OK to proceed?"_ Wait for explicit user confirmation. This applies even when the install is a documented prerequisite. Exception: the `/create-app` skill's global install of `@microsoft/cmr-cli@latest` is part of the documented setup flow, but still surface the install command before running it. - **Confirm before writing outside project root**: Before writing, editing, or deleting any file that is not inside the current project directory, ask the user for confirmation. - **Confirm before ACL changes**: Before running `ms app share` or `ms app unshare`, ask the user to confirm the email list. These mutate permissions on the cloud app. - **Confirm before `ms app delete`**: Always confirm. Never auto-`--force`, even when reading the slug from `ms.config.json`. @@ -48,7 +48,7 @@ Remove an inherited report so the CLI can detect the agent. - MUST NOT run `ms app deploy` if `npm run build` has not succeeded in the current session. - MUST NOT run `ms app deploy` from uncommitted or unpushed local changes. -- MUST NOT install `@microsoft/managed-apps-cli` per-workspace. The `@microsoft/managed-apps-cli` is installed globally so the `ms` binary is on PATH; the workspace stays clean. +- MUST NOT install `@microsoft/cmr-cli` per-workspace. The `@microsoft/cmr-cli` is installed globally so the `ms` binary is on PATH; the workspace stays clean. - MUST NOT edit generated codegen output in `generated/` unless the step explicitly calls for it. - MUST NOT install packages globally without user confirmation (see exception above for the documented setup flow). - MUST NOT remove `sharedConnectionId` from `ms.config.json` to get past an `allowedActions` validation failure. That field records how the connection was actually created; deleting it misrepresents the binding. Declare the actions instead. @@ -166,7 +166,7 @@ By default, `ms app create` resolves and uses an environment automatically β€” p **For external integrations, use Power Platform connectors. Never make direct API calls (fetch, axios, Graph API, Azure REST, etc.).** -Managed apps run inside a sandbox. Direct HTTP calls to external APIs will fail at runtime because the sandbox does not allow arbitrary outbound network requests β€” only connector-proxied calls work. +Apps on Copilot Managed Runtime run inside a sandbox. Direct HTTP calls to external APIs will fail at runtime because the sandbox does not allow arbitrary outbound network requests β€” only connector-proxied calls work. **If a connector exists for the service, use it β€” no exceptions.** @@ -214,7 +214,7 @@ This availability check does not establish runtime authorization. With the gate passed, Rayfin provides the app backend database, not an external integration. Follow `/add-backend` and its local modeling/CRUD references, -then use the existing managed apps build and deploy workflow. +then use the existing Copilot Managed Runtime build and deploy workflow. --- @@ -293,7 +293,7 @@ may block `blob:` URLs. See `/add-office365-users` for a complete chunk-safe con ## CLI Toolchain -The CLI is `@microsoft/managed-apps-cli` (binary `ms`), installed globally from the public npm registry. The `/create-app` skill handles install + binary-name probing. +The CLI is `@microsoft/cmr-cli` (binary `ms`), installed globally from the public npm registry. The `/create-app` skill handles install + binary-name probing. **Binary name:** use `ms`: diff --git a/plugins/microsoft-managed-apps/skills/add-backend/SKILL.md b/plugins/microsoft-managed-apps/skills/add-backend/SKILL.md index be4f2c6..c29d1e2 100644 --- a/plugins/microsoft-managed-apps/skills/add-backend/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-backend/SKILL.md @@ -42,7 +42,7 @@ implementation described in the references. Read the installed package docs identified in these references, then follow them in order: -- [Data modeling](./references/rayfin-data-modeling.md): entities, permissions and required [Managed Apps host initialization](./references/rayfin-data-modeling.md#step-4-initialize-through-managed-apps). +- [Data modeling](./references/rayfin-data-modeling.md): entities, permissions and required [Copilot Managed Runtime host initialization](./references/rayfin-data-modeling.md#step-4-initialize-through-copilot-managed-runtime). - [CRUD UI](./references/rayfin-crud-ui.md): lists, forms, mutations and persistence checks. When invoked from `/create-app`, complete data modeling in Step 9 and return the diff --git a/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-crud-ui.md b/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-crud-ui.md index ed3b3be..b98e46a 100644 --- a/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-crud-ui.md +++ b/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-crud-ui.md @@ -4,7 +4,7 @@ Reference for [/add-backend](../SKILL.md). ## Read the docs first -Use the entities and [host-initialized client](./rayfin-data-modeling.md#step-4-initialize-through-managed-apps) +Use the entities and [host-initialized client](./rayfin-data-modeling.md#step-4-initialize-through-copilot-managed-runtime) from data modeling. The client API belongs to the installed packages; this reference covers the UI. Paths are relative to the app root; complete the entry skill's `npm install` step diff --git a/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-data-modeling.md b/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-data-modeling.md index ae910d2..179dcf2 100644 --- a/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-data-modeling.md +++ b/plugins/microsoft-managed-apps/skills/add-backend/references/rayfin-data-modeling.md @@ -14,7 +14,7 @@ Current package-doc locations: | Topic | Installed documentation | | --- | --- | -| Managed Apps initialization and authentication | `node_modules/@microsoft/managed-apps/package.json`: follow the `./rayfin` export to its declarations. | +| Copilot Managed Runtime initialization and authentication | `node_modules/@microsoft/cmr-apps/package.json`: follow the `./rayfin` export to its declarations. | | Entities, fields and relationships | `node_modules/@microsoft/rayfin-core/assets/docs/decorators.md` | | Permissions, owner stamping and authentication shorthands | `node_modules/@microsoft/rayfin-core/assets/docs/permissions.md` | | Paging, cursors and text-field nullability | `node_modules/@microsoft/rayfin-data/assets/docs/index.md` | @@ -75,9 +75,9 @@ export type AppSchema = { Include relationship and join entities used by the app. Browser code must use `import type` for backend definitions. -## Step 4: Initialize through Managed Apps +## Step 4: Initialize through Copilot Managed Runtime -Use `initializeRayfin()` from `@microsoft/managed-apps/rayfin`, +Use `initializeRayfin()` from `@microsoft/cmr-apps/rayfin`, following the installed adapter docs and declarations. Reuse the resulting client for data operations and authentication; do not use standalone Rayfin configuration or a separate Fabric sign-in flow. diff --git a/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md b/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md index 343f05a..224bdf5 100644 --- a/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-data-source/SKILL.md @@ -1,6 +1,6 @@ --- name: add-data-source -description: Canonical add flow for Microsoft Managed Apps. Use when adding any data source through `ms app add data-source` (with `--as table` or `--as action`), or when the user wants help discovering which connector / api-id to use. +description: Canonical add flow for Copilot Managed Runtime. Use when adding any data source through `ms app add data-source` (with `--as table` or `--as action`), or when the user wants help discovering which connector / api-id to use. allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion Skill --- diff --git a/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md b/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md index ec26487..77009ea 100644 --- a/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-office365-users/SKILL.md @@ -92,7 +92,7 @@ Call `UserPhotoMetadata` before downloading the photo. `HasPhoto: false` is a va no-photo state; render initials or another accessible fallback. Image responses are a special runtime contract: the generated `UserPhoto_V2` signature may -declare `IOperationResult`, but the Managed Apps SDK decodes an `image/*` response into +declare `IOperationResult`, but the Copilot Managed Runtime SDK decodes an `image/*` response into a `Uint8Array`. Do not interpolate that byte array directly into a base64 URL, and do not use a `blob:` URLβ€”the deployed App Player content security policy may block `blob:` under `img-src`. diff --git a/plugins/microsoft-managed-apps/skills/add-workiq/SKILL.md b/plugins/microsoft-managed-apps/skills/add-workiq/SKILL.md index b3147d0..25ec872 100644 --- a/plugins/microsoft-managed-apps/skills/add-workiq/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/add-workiq/SKILL.md @@ -30,7 +30,7 @@ After the connector is added, you'll have access to `WorkIQCopilotMCPService`. * Create `src/connectors/mcpClient.ts`: ```typescript -import type { IOperationResult } from '@microsoft/managed-apps/data' +import type { IOperationResult } from '@microsoft/cmr-apps/data' import { WorkIQCopilotMCPService } from '../../generated/services/WorkIQCopilotMCPService' import type { QueryRequest } from '../../generated/models/WorkIQCopilotMCPModel' diff --git a/plugins/microsoft-managed-apps/skills/create-app/SKILL.md b/plugins/microsoft-managed-apps/skills/create-app/SKILL.md index 944e14a..e466ae4 100644 --- a/plugins/microsoft-managed-apps/skills/create-app/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/create-app/SKILL.md @@ -1,6 +1,6 @@ --- name: create-app -description: Creates managed apps using React and Vite. Use when scaffolding a new app with `ms app create` and ending on local dev with `ms app dev`. +description: Creates apps on Copilot Managed Runtime using React and Vite. Use when scaffolding a new app with `ms app create` and ending on local dev with `ms app dev`. allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion EnterPlanMode ExitPlanMode Skill --- @@ -13,7 +13,7 @@ allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion EnterPlanMode Exit # Create a Microsoft App -This skill scaffolds a new Microsoft App end-to-end using `@microsoft/managed-apps-cli` (binary `ms`). The default outcome is a **running local dev server**, not a deployed cloud app. Deploying is a separate, explicit user choice via `/deploy`. +This skill scaffolds a new Microsoft App end-to-end using `@microsoft/cmr-cli` (binary `ms`). The default outcome is a **running local dev server**, not a deployed cloud app. Deploying is a separate, explicit user choice via `/deploy`. ## Workflow @@ -44,17 +44,17 @@ ms --version 2>/dev/null # Probe the bin name - **Missing `ms`**: proceed to the global install block below. Confirm with the user before running `npm install -g`. - **One of them resolves**: record which binary name resolved (`$BIN`); use it in every subsequent step. -#### Global install of `@microsoft/managed-apps-cli` (only if `ms` is missing) +#### Global install of `@microsoft/cmr-cli` (only if `ms` is missing) Install the CLI **globally** from the public npm registry so the `ms` binary is on PATH. -Ask the user: _"This will install `@microsoft/managed-apps-cli@latest` globally on your machine. OK to proceed?"_ Wait for explicit yes. +Ask the user: _"This will install `@microsoft/cmr-cli@latest` globally on your machine. OK to proceed?"_ Wait for explicit yes. Then run: ```bash # Install globally, pinned to the @latest stable tag. -npm install -g @microsoft/managed-apps-cli@latest +npm install -g @microsoft/cmr-cli@latest # Re-probe the bin name. ms --version diff --git a/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md b/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md index e176871..feeac86 100644 --- a/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md +++ b/plugins/microsoft-managed-apps/skills/create-app/references/prerequisites-reference.md @@ -7,23 +7,23 @@ | Node.js | **v22+** | `node --version` | https://nodejs.org/ | | Git | Any 2.x | `git --version` | https://git-scm.com/ β€” required (`ms app create` initializes a repo). | | Git Credential Manager | Bundled with Git for Windows | `git credential-manager --version` | First `ms app create` triggers an interactive browser flow against the remote git endpoint. See [troubleshooting.md](./troubleshooting.md#first-run-git-credential-manager-trap). | -| `@microsoft/managed-apps-cli` | `@latest` tag | `ms --version` | Install globally only β€” see below. | +| `@microsoft/cmr-cli` | `@latest` tag | `ms --version` | Install globally only β€” see below. | ## Required Account -- A Microsoft work/school account with access to a managed apps-enabled tenant. +- A Microsoft work/school account with access to a Copilot Managed Runtime-enabled tenant. - `ms app create` resolves an environment automatically β€” you do not need to know or provide one. (Advanced users who already have a specific environment ID can pass it via `--environment-id`.) -## Installing `@microsoft/managed-apps-cli` +## Installing `@microsoft/cmr-cli` -The CLI is published on the public npm registry: [`@microsoft/managed-apps-cli`](https://www.npmjs.com/package/@microsoft/managed-apps-cli). +The setup flow requires an available release of [`@microsoft/cmr-cli`](https://www.npmjs.com/package/@microsoft/cmr-cli) on the public npm registry. **Shell note:** the snippets below are shown in bash. If you're on PowerShell, use the equivalents called out in [shared-instructions.md](../../../shared/shared-instructions.md#shell-compatibility) instead of copying the bash syntax literally. ### Global install (pinned to `@latest`) ```bash -npm install -g @microsoft/managed-apps-cli@latest +npm install -g @microsoft/cmr-cli@latest ``` Install globally so the `ms` binary is on PATH. Subsequent `ms` invocations resolve the binary from the global install path. @@ -34,11 +34,11 @@ Before the first operational `ms` command in a top-level workflow, follow the [C ### Override patterns (only with explicit user direction) -- Specific build for repro: `npm install -g @microsoft/managed-apps-cli@` +- Specific build for repro: `npm install -g @microsoft/cmr-cli@` ### What NOT to do -- **Do NOT** run `npm install --save-dev @microsoft/managed-apps-cli` per-workspace. Install globally so the `ms` binary is on PATH and the per-app workspace stays clean. +- **Do NOT** run `npm install --save-dev @microsoft/cmr-cli` per-workspace. Install globally so the `ms` binary is on PATH and the per-app workspace stays clean. - **Do NOT** use `npx ms` from inside a project β€” `npx` may resolve to an unrelated public-registry package named `ms` (a date-parser shim). ## Required Permissions (`allowedPrompts`) @@ -49,7 +49,7 @@ When using plan mode, include these in `allowedPrompts`: { "allowedPrompts": [ { "tool": "Bash", "prompt": "check tool versions (node, git, ms)" }, - { "tool": "Bash", "prompt": "install @microsoft/managed-apps-cli globally" }, + { "tool": "Bash", "prompt": "install @microsoft/cmr-cli globally" }, { "tool": "Bash", "prompt": "ms auth status / ms auth login" }, { "tool": "Bash", "prompt": "ms app create / ms app delete (recovery)" }, { "tool": "Bash", "prompt": "npm install / npm run build" }, diff --git a/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md b/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md index bfeaec9..b0c1deb 100644 --- a/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/list-apps/SKILL.md @@ -1,6 +1,6 @@ --- name: list-apps -description: Discovers managed apps in the active environment via `ms app list --json` and optional `ms app show --json`. Use when listing or locating apps. +description: Discovers apps on Copilot Managed Runtime in the active environment via `ms app list --json` and optional `ms app show --json`. Use when listing or locating apps. allowed-tools: Read Grep Bash AskUserQuestion --- diff --git a/plugins/microsoft-managed-apps/skills/state/SKILL.md b/plugins/microsoft-managed-apps/skills/state/SKILL.md index e136579..1a7ab45 100644 --- a/plugins/microsoft-managed-apps/skills/state/SKILL.md +++ b/plugins/microsoft-managed-apps/skills/state/SKILL.md @@ -6,7 +6,7 @@ allowed-tools: Read Edit Write Grep Glob Bash AskUserQuestion **πŸ“‹ Shared Instructions: [shared-instructions.md](../../shared/shared-instructions.md)** β€” Cross-cutting concerns. -# Managed Apps State with CLI schema + generated client +# Copilot Managed Runtime State with CLI schema + generated client Every Microsoft Managed App can use built-in app state when the `state` feature is enabled for the current CLI/environment: a NoSQL store the app calls directly (no middle-tier function, connector, @@ -50,21 +50,21 @@ feature. ## ⚠️ Local testing requires local gateway mode -Generated state services require the Managed Apps local gateway path during local development. -Before testing data behavior locally, make sure the app has `@microsoft/managed-apps-vite-plugin` +Generated state services require the Copilot Managed Runtime local gateway path during local development. +Before testing data behavior locally, make sure the app has `@microsoft/cmr-apps-vite-plugin` 0.4.2 or later (the version that added `devMode: 'localGateway'`; older versions won't start the local gateway), then opt the app into local gateway mode. -Check the installed version first, for example with `npm ls @microsoft/managed-apps-vite-plugin` -(or read `version` in `node_modules/@microsoft/managed-apps-vite-plugin/package.json`). If it is +Check the installed version first, for example with `npm ls @microsoft/cmr-apps-vite-plugin` +(or read `version` in `node_modules/@microsoft/cmr-apps-vite-plugin/package.json`). If it is 0.4.2 or later, skip the install. If it is missing or older, install the latest with the app's package manager: ```bash -npm install -D @microsoft/managed-apps-vite-plugin@latest -# or: bun add -D @microsoft/managed-apps-vite-plugin@latest -# or: pnpm add -D @microsoft/managed-apps-vite-plugin@latest -# or: yarn add -D @microsoft/managed-apps-vite-plugin@latest +npm install -D @microsoft/cmr-apps-vite-plugin@latest +# or: bun add -D @microsoft/cmr-apps-vite-plugin@latest +# or: pnpm add -D @microsoft/cmr-apps-vite-plugin@latest +# or: yarn add -D @microsoft/cmr-apps-vite-plugin@latest ``` Then update the app's `vite.config.ts` so the `managedApps()` plugin call enables the local gateway, @@ -371,7 +371,7 @@ ms project state generate-code --json Then: - confirm `ms.config.json` has `enabled: true` on its state (or `data`/`db`) section; -- confirm the app has `@microsoft/managed-apps-vite-plugin` 0.4.2 or later; +- confirm the app has `@microsoft/cmr-apps-vite-plugin` 0.4.2 or later; - confirm `vite.config.ts` calls `managedApps({ devMode: 'localGateway' })` or preserves existing options while adding `devMode: 'localGateway'`; - run the narrowest relevant build/typecheck/lint for the app or package; diff --git a/schemas/README.md b/schemas/README.md index 093a25e..c8b4b70 100644 --- a/schemas/README.md +++ b/schemas/README.md @@ -19,7 +19,7 @@ https://raw.githubusercontent.com/microsoft/Managed-Apps/main/schemas/stage-over ## Do not hand-edit Both files are generated from the Zod contracts that the CLI and runtime validate against -(`@microsoft/managed-apps-common`, `src/config/V0/Schema.ts` and +(`@microsoft/cmr-apps-common`, `src/config/V0/Schema.ts` and `src/config/stage/OverlaySchema.ts`). Editing them here would let the published schema drift from what the CLI actually enforces. Regenerate from the product repo and open a PR with the result instead. diff --git a/scripts/plugin-hooks.test.mjs b/scripts/plugin-hooks.test.mjs index ab7e655..56cae34 100644 --- a/scripts/plugin-hooks.test.mjs +++ b/scripts/plugin-hooks.test.mjs @@ -9,7 +9,7 @@ import test from 'node:test'; const root = resolve(dirname(fileURLToPath(import.meta.url)), '..'); const windows = process.platform === 'win32'; const shell = windows ? 'powershell' : 'bash'; -const directory = mkdtempSync(join(tmpdir(), 'managed apps hooks ')); +const directory = mkdtempSync(join(tmpdir(), 'Copilot Managed Runtime hooks ')); cpSync(join(root, 'plugins/microsoft-managed-apps/hooks'), join(directory, 'hooks'), { recursive: true }); test.after(() => rmSync(directory, { recursive: true, force: true })); diff --git a/templates/vite8/package.json b/templates/vite8/package.json index dea730b..73f308b 100644 --- a/templates/vite8/package.json +++ b/templates/vite8/package.json @@ -10,13 +10,13 @@ "preview": "vite preview" }, "dependencies": { - "@microsoft/managed-apps": "^0.6.3", + "@microsoft/cmr-apps": "^0.6.3", "react": "^19.2.6", "react-dom": "^19.2.6" }, "devDependencies": { "@eslint/js": "^10.0.1", - "@microsoft/managed-apps-vite-plugin": "^0.4.8", + "@microsoft/cmr-apps-vite-plugin": "^0.4.8", "@types/node": "^24.12.3", "@types/react": "^19.2.14", "@types/react-dom": "^19.2.3", diff --git a/templates/vite8/src/App.tsx b/templates/vite8/src/App.tsx index f92487c..4e162c0 100644 --- a/templates/vite8/src/App.tsx +++ b/templates/vite8/src/App.tsx @@ -37,8 +37,8 @@ function App() { -

Microsoft managed apps Documentation

-

Build and ship managed apps

+

Copilot Managed Runtime Documentation

+

Build and ship apps on Copilot Managed Runtime