mfeflow 0.5.0 → 0.6.0

package/assets/templates/polyrepo/files/shell/README.md.eta

@@ -0,0 +1,32 @@
+# <%= it.scope.slice(1) %>-shell
+
+The shell of a polyrepo made with [mfeflow](https://github.com/mfeflow/mfeflow): routes, layout and
+the registry that tells it which build of each remote to load. The remotes are in their own repos.
+
+```
+apps/shell                                  the host
+apps/shell/public/config/runtime-config.*   per environment; dev lists where the remotes run
+registry/envs                               which build of each remote staging and prod serve
+```
+
+## Run it
+
+```sh
+pnpm install
+pnpm dev
+```
+
+`pnpm dev` starts the shell on http://localhost:4300. It finds each remote in `devRemotes` in
+`apps/shell/public/config/runtime-config.dev.json`. Start a remote with `pnpm dev` in its own repo.
+
+`pnpm mfeflow dev` runs the shell the same way and reloads the list when that file changes.
+Point one remote somewhere else for a run with `pnpm mfeflow dev --remote cart=http://localhost:3001`.
+
+## Add a team repo
+
+```sh
+pnpm mfeflow add team-repo checkout
+```
+
+This creates `../checkout` as a new git repo and registers it here. Run `git init` and the GitHub
+steps yourself.

package/assets/templates/polyrepo/files/tsconfig.base.json.eta

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "verbatimModuleSyntax": true,
+    "declaration": true,
+    "skipLibCheck": true,
+    "types": []
+  }
+}

package/assets/templates/polyrepo/files/workflows/platform-ci.yml

@@ -0,0 +1,29 @@
+name: ci
+
+on:
+  pull_request:
+
+permissions: {}
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
+      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
+        with:
+          node-version: lts/*
+          cache: pnpm
+      - run: pnpm install
+      - run: pnpm build
+      - run: pnpm mfeflow validate

package/assets/templates/polyrepo/files/workflows/release.yml

@@ -0,0 +1,40 @@
+name: release
+
+# Publishes the packages in packages/ when a "chore: version packages" pull request is merged.
+# Set the NPM_TOKEN secret for npm, or change the registry in .npmrc for GitHub Packages.
+# Dormant until the repository variable RELEASE_ENABLED is 'true'.
+on:
+  push:
+    branches: [main]
+
+permissions: {}
+
+concurrency:
+  group: release
+  cancel-in-progress: false
+
+jobs:
+  release:
+    if: vars.RELEASE_ENABLED == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
+      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
+        with:
+          node-version: lts/*
+          registry-url: https://registry.npmjs.org
+      - run: pnpm install
+      - uses: changesets/action@ae32849d5ba541f9ae29e40e22a623bc13562f51 # v2.1.2
+        with:
+          publish: pnpm release
+          pr-title: 'chore: version packages'
+          commit-message: 'chore: version packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/assets/templates/polyrepo/files/workflows/reusable-ci.yml.eta

@@ -0,0 +1,50 @@
+name: reusable-ci
+
+# Every team repo calls this file from its own workflow:
+#
+#   jobs:
+#     ci:
+#       uses: <%= it.options.org || it.scope.slice(1) %>/platform/.github/workflows/reusable-ci.yml@main
+#
+# A private platform repo has to allow it under Settings > Actions > General > Access.
+on:
+  workflow_call:
+    inputs:
+      node-version:
+        description: Node version to run the checks on
+        type: string
+        default: lts/*
+      run-budget:
+        description: Also run mfeflow budget after the build
+        type: boolean
+        default: false
+
+permissions: {}
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: pnpm/action-setup@ea17c68df8912ef543352723c149a84f56e3d413 # v6.1.0
+      - uses: actions/setup-node@949feb2413d6458794dcd2491c4babbbce0c15c1 # v7.1.0
+        with:
+          node-version: ${{ inputs.node-version }}
+          cache: pnpm
+      - run: pnpm install
+      - run: pnpm run --if-present typecheck
+      - run: pnpm run --if-present lint
+      - run: pnpm run --if-present test
+      - run: pnpm build
+      - name: mfeflow validate
+        run: pnpm mfeflow validate
+      - name: mfeflow doctor
+        run: pnpm mfeflow doctor
+      - name: mfeflow budget
+        if: ${{ inputs.run-budget }}
+        run: pnpm mfeflow budget

package/assets/templates/polyrepo/files/workflows/team-ci.yml.eta

@@ -0,0 +1,12 @@
+name: ci
+
+on:
+  pull_request:
+
+permissions: {}
+
+jobs:
+  ci:
+    permissions:
+      contents: read
+    uses: <%= it.options.org || it.scope.slice(1) %>/platform/.github/workflows/reusable-ci.yml@main

package/dist/against.d.ts

@@ -0,0 +1,16 @@
+import { type FetchLike } from '@mfeflow/core';
+/** The shell a remote is checked against, as its deployed `mf-manifest.json`. */
+export interface ShellSource {
+    /** What the user passed, for the report. */
+    from: string;
+    manifest: unknown;
+}
+/**
+ * The shell's `mf-manifest.json` from `source`: the manifest itself, or a registry index, whose
+ * `shell/mf-manifest.json` is read from beside it. `source` is a file or an https URL (http on
+ * localhost). Fails with E307 on anything else.
+ */
+export declare function loadShell(source: string, options: {
+    cwd: string;
+    fetch: FetchLike;
+}): Promise<ShellSource>;

package/dist/catalog.d.ts

@@ -13,6 +13,8 @@ export declare function isFirstParty(name: string): boolean;
 /** The first-party features a user may pick, in catalogue order. */
 export declare const OPTIONAL_FEATURES: readonly string[];
 export declare const DEFAULT_FEATURES: readonly string[];
+/** `polyrepo` is applied by `init --topology polyrepo`; it is not offered by `add` or listed by `features`. */
+export declare const POLYREPO_FEATURE = "polyrepo";
 export interface FeatureSource {
     roots: AssetRoots;
     registries?: Record<string, string> | undefined;
@@ -26,3 +28,5 @@ export interface FeatureSource {
 }
 /** A first-party feature by name, or `@namespace/name` from a configured registry. */
 export declare function loadAny(name: string, source: FeatureSource): Promise<LoadedFeature>;
+/** First-party features in the order `init` applies them, then the rest as typed: a feature may edit another's files. */
+export declare function inCatalogueOrder(names: readonly string[]): string[];

package/dist/checks/compat.d.ts

@@ -1,2 +1,14 @@
 import { type Check } from '../findings.js';
+/** Where the shell's versions come from when it is not in this repo. */
+export interface AgainstShell {
+    from: string;
+    manifest: unknown;
+}
+export declare const ABSENT_SHELL_WARNING = "shell is not in this repo, pass --against <url|file>";
+/**
+ * Each remote's shared ranges against the shell. The shell comes from `against` (a deployed
+ * manifest) when given, else from the shells in this repo; with neither, the check warns
+ * instead of passing.
+ */
+export declare function compatCheck(against?: AgainstShell, under?: 'check-compat' | 'doctor'): Check;
 export declare const compat: Check;

package/dist/checks/index.d.ts

@@ -1,6 +1,5 @@
 import type { Check } from '../findings.js';
 /** What `mfeflow validate` runs: the files against their schemas and each other. */
 export declare const VALIDATE_CHECKS: readonly Check[];
-export declare const COMPAT_CHECKS: readonly Check[];
 /** Every check `mfeflow doctor` runs, in order. */
 export declare const DOCTOR_CHECKS: readonly Check[];

package/dist/commands/add.d.ts

@@ -83,6 +83,4 @@ export declare const ADD_ARGS: {
         readonly description: 'Take a registry feature whose content differs from the hash recorded in mfeflow.json';
     };
 };
-/** First-party features in the order `init` applies them, then the rest as typed: a feature may edit another's files. */
-export declare function inCatalogueOrder(names: readonly string[]): string[];
 export declare function runAdd(rt: Runtime, args: Record<string, unknown>, raw: readonly string[]): Promise<AddResult>;

package/dist/commands/adopt.d.ts

@@ -0,0 +1,54 @@
+import { type Plan } from '@mfeflow/core';
+import { type AdoptResult } from '../output.js';
+import type { Runtime } from '../runtime.js';
+export declare const ADOPT_ARGS: {
+    readonly yes: {
+        readonly type: 'boolean';
+        readonly alias: 'y';
+        readonly description: 'Take the defaults and never prompt';
+    };
+    readonly preset: {
+        readonly type: 'string';
+        readonly description: 'Replay options from a JSON file or an https URL';
+        readonly valueHint: 'file|url';
+    };
+    readonly json: {
+        readonly type: 'boolean';
+        readonly description: 'Print one JSON document on stdout, nothing else';
+    };
+    readonly 'dry-run': {
+        readonly type: 'boolean';
+        readonly description: 'Print the summary and diff, write nothing';
+    };
+    readonly cwd: {
+        readonly type: 'string';
+        readonly description: 'Run as if started in this folder';
+        readonly valueHint: 'dir';
+    };
+    readonly install: {
+        readonly type: 'boolean';
+        readonly default: true;
+        readonly description: 'Run the package manager after writing (--no-install to skip)';
+    };
+    readonly verbose: {
+        readonly type: 'boolean';
+        readonly description: 'Show package manager output and stack traces';
+    };
+    readonly local: {
+        readonly type: 'string';
+        readonly description: 'Link @mfeflow/* from a built mfeflow checkout (env MFEFLOW_LOCAL)';
+        readonly valueHint: 'path';
+    };
+    readonly help: {
+        readonly type: 'boolean';
+        readonly alias: 'h';
+        readonly description: 'Show this help';
+    };
+};
+/** The lines to paste into the shared list of a build config, which adopt never edits. */
+export declare const SHARED_SNIPPET = "    '@mfeflow/runtime': { singleton: true },";
+/** mfeflow.json may have appeared since the first check; the plan would then overwrite it. */
+export declare function assertNoProjectFile(plan: Plan): void;
+/** A last guard behind the promise that adopt never edits a build config. */
+export declare function assertBuildConfigUntouched(plan: Plan, buildConfig: readonly string[]): void;
+export declare function runAdopt(rt: Runtime, args: Record<string, unknown>, raw: readonly string[]): Promise<AdoptResult>;

package/dist/commands/deploy.d.ts

@@ -43,6 +43,21 @@ export declare const DEPLOY_ARGS: {
         readonly alias: 'h';
         readonly description: 'Show this help';
     };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+    readonly percent: {
+        readonly type: 'string';
+        readonly description: 'Start a percentage rollout at this share of visitors, 1 to 99 (registry server only)';
+        readonly valueHint: 'n';
+    };
+    readonly steps: {
+        readonly type: 'string';
+        readonly description: 'Later rollout steps, rising, like 50,100 (needs --percent)';
+        readonly valueHint: 'a,b,c';
+    };
     readonly host: {
         readonly type: 'string';
         readonly description: 'Where the registry lives: file:<dir> or s3://<bucket>[/prefix] (default registry.host)';
@@ -122,6 +137,21 @@ export declare const PROMOTE_ARGS: {
         readonly alias: 'h';
         readonly description: 'Show this help';
     };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+    readonly percent: {
+        readonly type: 'string';
+        readonly description: 'Start a percentage rollout at this share of visitors, 1 to 99 (registry server only)';
+        readonly valueHint: 'n';
+    };
+    readonly steps: {
+        readonly type: 'string';
+        readonly description: 'Later rollout steps, rising, like 50,100 (needs --percent)';
+        readonly valueHint: 'a,b,c';
+    };
     readonly host: {
         readonly type: 'string';
         readonly description: 'Where the registry lives: file:<dir> or s3://<bucket>[/prefix] (default registry.host)';
@@ -191,6 +221,11 @@ export declare const ROLLBACK_ARGS: {
         readonly alias: 'h';
         readonly description: 'Show this help';
     };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
     readonly host: {
         readonly type: 'string';
         readonly description: 'Where the registry lives: file:<dir> or s3://<bucket>[/prefix] (default registry.host)';

package/dist/commands/doctor.d.ts

@@ -135,6 +135,11 @@ export declare const COMPAT_ARGS: {
         readonly alias: 'h';
         readonly description: 'Show this help';
     };
+    readonly against: {
+        readonly type: 'string';
+        readonly description: 'Check against the shell a registry index or a deployed mf-manifest.json describes (file or https URL)';
+        readonly valueHint: 'url|file';
+    };
 };
 export declare function runDoctor(rt: Runtime, args: Record<string, unknown>, raw: readonly string[]): Promise<ReportResult>;
 export declare function runValidate(rt: Runtime, args: Record<string, unknown>, raw: readonly string[]): Promise<ReportResult>;

package/dist/commands/init.d.ts

@@ -74,16 +74,24 @@ export declare const INIT_ARGS: {
     };
     readonly topology: {
         readonly type: 'string';
-        readonly description: 'monorepo (the only one in this release)';
+        readonly description: 'monorepo (default), or polyrepo: a platform repo, a shell repo and a repo for each remote';
         readonly valueHint: 'name';
     };
+    readonly org: {
+        readonly type: 'string';
+        readonly description: 'polyrepo: the GitHub owner the CI and Renovate files point at (default: the scope without @)';
+        readonly valueHint: 'owner';
+    };
     readonly option: {
         readonly type: 'string';
         readonly description: 'A feature option, repeatable: --option feature.key=value';
         readonly valueHint: 'f.k=v';
     };
 };
+export type Topology = 'monorepo' | 'polyrepo';
 export interface InitOptions {
+    topology: Topology;
+    org?: string;
     dir: string;
     scope: string;
     remotes: string[];

package/dist/commands/server-mode.d.ts

@@ -0,0 +1,210 @@
+import type { ArgsDef } from 'citty';
+import type { DeployResult, KillCommandResult, RolloutCommandResult, StatusResult } from '../output.js';
+import type { Runtime } from '../runtime.js';
+import type { ServerClient } from '../server-client.js';
+export declare const SERVER_ARGS: {
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+};
+export declare const ROLLOUT_ARGS: {
+    readonly percent: {
+        readonly type: 'string';
+        readonly description: 'Start a percentage rollout at this share of visitors, 1 to 99 (registry server only)';
+        readonly valueHint: 'n';
+    };
+    readonly steps: {
+        readonly type: 'string';
+        readonly description: 'Later rollout steps, rising, like 50,100 (needs --percent)';
+        readonly valueHint: 'a,b,c';
+    };
+};
+export declare const ROLLOUT_CMD_ARGS: {
+    readonly yes: {
+        readonly type: 'boolean';
+        readonly alias: 'y';
+        readonly description: 'Take the defaults and never prompt';
+    };
+    readonly preset: {
+        readonly type: 'string';
+        readonly description: 'Replay options from a JSON file or an https URL';
+        readonly valueHint: 'file|url';
+    };
+    readonly json: {
+        readonly type: 'boolean';
+        readonly description: 'Print one JSON document on stdout, nothing else';
+    };
+    readonly 'dry-run': {
+        readonly type: 'boolean';
+        readonly description: 'Print the summary and diff, write nothing';
+    };
+    readonly cwd: {
+        readonly type: 'string';
+        readonly description: 'Run as if started in this folder';
+        readonly valueHint: 'dir';
+    };
+    readonly install: {
+        readonly type: 'boolean';
+        readonly default: true;
+        readonly description: 'Run the package manager after writing (--no-install to skip)';
+    };
+    readonly verbose: {
+        readonly type: 'boolean';
+        readonly description: 'Show package manager output and stack traces';
+    };
+    readonly local: {
+        readonly type: 'string';
+        readonly description: 'Link @mfeflow/* from a built mfeflow checkout (env MFEFLOW_LOCAL)';
+        readonly valueHint: 'path';
+    };
+    readonly help: {
+        readonly type: 'boolean';
+        readonly alias: 'h';
+        readonly description: 'Show this help';
+    };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+    readonly env: {
+        readonly type: 'string';
+        readonly description: 'Environment the rollout runs in';
+        readonly valueHint: 'env';
+    };
+    readonly reason: {
+        readonly type: 'string';
+        readonly description: 'Why, for the audit log (abort only)';
+        readonly valueHint: 'text';
+    };
+};
+export declare const KILL_ARGS: {
+    readonly yes: {
+        readonly type: 'boolean';
+        readonly alias: 'y';
+        readonly description: 'Take the defaults and never prompt';
+    };
+    readonly preset: {
+        readonly type: 'string';
+        readonly description: 'Replay options from a JSON file or an https URL';
+        readonly valueHint: 'file|url';
+    };
+    readonly json: {
+        readonly type: 'boolean';
+        readonly description: 'Print one JSON document on stdout, nothing else';
+    };
+    readonly 'dry-run': {
+        readonly type: 'boolean';
+        readonly description: 'Print the summary and diff, write nothing';
+    };
+    readonly cwd: {
+        readonly type: 'string';
+        readonly description: 'Run as if started in this folder';
+        readonly valueHint: 'dir';
+    };
+    readonly install: {
+        readonly type: 'boolean';
+        readonly default: true;
+        readonly description: 'Run the package manager after writing (--no-install to skip)';
+    };
+    readonly verbose: {
+        readonly type: 'boolean';
+        readonly description: 'Show package manager output and stack traces';
+    };
+    readonly local: {
+        readonly type: 'string';
+        readonly description: 'Link @mfeflow/* from a built mfeflow checkout (env MFEFLOW_LOCAL)';
+        readonly valueHint: 'path';
+    };
+    readonly help: {
+        readonly type: 'boolean';
+        readonly alias: 'h';
+        readonly description: 'Show this help';
+    };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+    readonly env: {
+        readonly type: 'string';
+        readonly description: 'Environment to remove the remote from';
+        readonly valueHint: 'env';
+    };
+    readonly reason: {
+        readonly type: 'string';
+        readonly description: 'Why, for the audit log';
+        readonly valueHint: 'text';
+    };
+};
+export declare const RESTORE_ARGS: {
+    readonly yes: {
+        readonly type: 'boolean';
+        readonly alias: 'y';
+        readonly description: 'Take the defaults and never prompt';
+    };
+    readonly preset: {
+        readonly type: 'string';
+        readonly description: 'Replay options from a JSON file or an https URL';
+        readonly valueHint: 'file|url';
+    };
+    readonly json: {
+        readonly type: 'boolean';
+        readonly description: 'Print one JSON document on stdout, nothing else';
+    };
+    readonly 'dry-run': {
+        readonly type: 'boolean';
+        readonly description: 'Print the summary and diff, write nothing';
+    };
+    readonly cwd: {
+        readonly type: 'string';
+        readonly description: 'Run as if started in this folder';
+        readonly valueHint: 'dir';
+    };
+    readonly install: {
+        readonly type: 'boolean';
+        readonly default: true;
+        readonly description: 'Run the package manager after writing (--no-install to skip)';
+    };
+    readonly verbose: {
+        readonly type: 'boolean';
+        readonly description: 'Show package manager output and stack traces';
+    };
+    readonly local: {
+        readonly type: 'string';
+        readonly description: 'Link @mfeflow/* from a built mfeflow checkout (env MFEFLOW_LOCAL)';
+        readonly valueHint: 'path';
+    };
+    readonly help: {
+        readonly type: 'boolean';
+        readonly alias: 'h';
+        readonly description: 'Show this help';
+    };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
+    readonly env: {
+        readonly type: 'string';
+        readonly description: 'Environment to put the remote back in';
+        readonly valueHint: 'env';
+    };
+};
+export interface RolloutPlan {
+    percent: number;
+    steps: number[];
+}
+/** `--percent` and `--steps` as the server wants them, or undefined when neither is given. */
+export declare function rolloutOf(args: Record<string, unknown>): RolloutPlan | undefined;
+/** A rollout was asked for in static mode, which has no way to split traffic. */
+export declare function refuseRolloutFlags(args: Record<string, unknown>): void;
+export declare function deployViaServer(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], defs: ArgsDef, client: ServerClient): Promise<DeployResult>;
+export declare function promoteViaServer(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], defs: ArgsDef, client: ServerClient): Promise<DeployResult>;
+export declare function rollbackViaServer(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], defs: ArgsDef, client: ServerClient): Promise<DeployResult>;
+export declare function statusViaServer(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], defs: ArgsDef, client: ServerClient): Promise<StatusResult>;
+export declare function runRolloutCommand(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], client: ServerClient | undefined): Promise<RolloutCommandResult>;
+export declare function runKillCommand(rt: Runtime, args: Record<string, unknown>, raw: readonly string[], restore: boolean, client: ServerClient | undefined): Promise<KillCommandResult>;
+export declare function formatServerAction(result: RolloutCommandResult | KillCommandResult): string;

package/dist/commands/status.d.ts

@@ -43,6 +43,11 @@ export declare const STATUS_ARGS: {
         readonly alias: 'h';
         readonly description: 'Show this help';
     };
+    readonly 'registry-url': {
+        readonly type: 'string';
+        readonly description: 'Registry server address (env MFEFLOW_REGISTRY_URL). The token is only read from MFEFLOW_REGISTRY_TOKEN';
+        readonly valueHint: 'url';
+    };
     readonly env: {
         readonly type: 'string';
         readonly description: 'Only this environment (default: every env on the host, and every folder in registry/envs but dev)';

package/dist/commands/team-repo.d.ts

@@ -0,0 +1,9 @@
+import type { Globals } from '../args.js';
+import { type AddResult } from '../output.js';
+import type { Runtime } from '../runtime.js';
+/**
+ * `mfeflow add team-repo <name>`, run in the shell repo: makes `../<name>` a new git repo with the
+ * remote in it, then registers the remote here (a route, staging and prod registry entries and its
+ * dev server in the dev config). The new repo is written first, so a failure here leaves no folder.
+ */
+export declare function addTeamRepo(rt: Runtime, globals: Globals, args: Record<string, unknown>, given: string | undefined): Promise<AddResult>;