@webship.co/workspace-sandboxes 0.0.0-stage → 1.0.0-beta1

package/README.md

@@ -1,3 +1,54 @@
-# Temporary Holding Version
+# @webship.co/workspace-sandboxes
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The **Sandboxes** workspace of the [Webship Workspace](https://github.com/webship/workspace) dashboard:
+the `sandboxes/` folder (type `sites`), its settings file (`core/config/workspace.sandboxes.settings.yml`),
+its commands and its docs, as a plugin.
+
+## Use it
+
+```bash
+cd ~/workspace
+bash core/scripts/plugins.sh --require github:webship/workspace-sandboxes
+bash core/scripts/plugins.sh --activate sandboxes     # puts `sandboxes` on the workspaces list of settings.yml
+bash core/scripts/plugins.sh --install sandboxes      # the folder, its settings file (once), its commands, its docs (once)
+```
+
+The settings file and the docs are placed once and never overwritten: they hold what you put there.
+`--deactivate` takes the workspace off the list; the folder and its content stay.
+
+## The commands
+
+| Command |
+| --- |
+| `cmd-cucumber11-0-x-project.sh` |
+| `cmd-drupal10-3-x-recommended-project.sh` |
+| `cmd-drupal10-recommended-project.sh` |
+| `cmd-drupal11-0-x-recommended-project.sh` |
+| `cmd-drupal11-4-0-recommended-project.sh` |
+| `cmd-drupal11-4-x-recommended-project.sh` |
+| `cmd-drupal11-recommended-project.sh` |
+| `cmd-drupal12-recommended-project.sh` |
+| `cmd-drupal9-recommended-project.sh` |
+| `cmd-drupalcms2-1-0-project.sh` |
+| `cmd-drupalcms2-x-project.sh` |
+| `cmd-odoo20-project.sh` |
+| `cmd-tools-add-users.sh` |
+| `cmd-tools-backup-sandboxes.sh` |
+| `cmd-tools-cancel-users.sh` |
+| `cmd-tools-checks.sh` |
+| `cmd-tools-clone.sh` |
+| `cmd-tools-hostnames.sh` |
+| `cmd-tools-reclaim.sh` |
+| `cmd-tools-remove.sh` |
+| `cmd-tools-screen.sh` |
+| `cmd-tools-testing.sh` |
+| `cmd-tools-update-all.sh` |
+| `cmd-webship11-0-0-project.sh` |
+| `cmd-webship11-0-x-project.sh` |
+| `cmd-webships2-0-0-project.sh` |
+| `cmd-webships2-0-x-project.sh` |
+| `cmd-webships3-0-x-project.sh` |
+| `cmd-wordpress-project.sh` |
+| `cmd-wpbedrock1-project.sh` |
+
+The bash functions these commands call live in the dashboard's `core/scripts/functions`.

package/commands/cmd-cucumber11-0-x-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Cucumber 11.0.x
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version.
+site_version="11.0.x-dev";
+
+# Distribution.
+distribution_name="cucumber";
+distribution_title="Cucumber";
+distribution_webroot="web";
+distribution_profile_repo="webship/cucumber";
+distribution_project_template="webship/cucumber-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal10-3-x-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 10.3.x (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="10.3.x-dev";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal10-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 10 (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="~10.0";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal11-0-x-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 11.0.x (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="11.0.x-dev";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal11-4-0-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 11.4.0 (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="~11.4.0";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal11-4-x-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 11.4.x (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="11.4.x-dev";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal11-recommended-project.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 11 (latest)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="^11";
+site_version_dev="11.x-dev";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal12-recommended-project.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 12 (latest)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="^12";
+site_version_dev="12.x-dev";
+# Drupal 12 has no stable release yet, so the caret constraint above matches only a
+# pre-release and composer's default `stable` minimum would resolve to nothing. This is
+# the floor this builder accepts; composer still takes the highest match, so 12.0.0 wins
+# the day it lands and this line can simply go.
+site_version_stability="alpha";
+# drupal/core 12 requires php >= 8.5.0, and DDEV's default is 8.4.
+site_php_version="8.5";
+# Core 12 requires guzzle 8. Every TAGGED Drush requires guzzle ^7 — 14.x is the first
+# branch to allow 8 and it has no release yet, so the development branch is the only
+# Drush that can sit beside Drupal 12 today. Swap this for `^14` when 14.0.0 is tagged.
+site_drush_version="14.x-dev";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupal9-recommended-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal 9 (recommended project)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="~9";
+
+# Distribution.
+distribution_name="drupal";
+distribution_title="Drupal";
+distribution_webroot="web";
+distribution_profile_repo="drupal/core";
+distribution_project_template="drupal/recommended-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupalcms2-1-0-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal CMS 2.1.0
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="~2.1.0";
+
+# Distribution.
+distribution_name="drupal_cms";
+distribution_title="Drupal CMS";
+distribution_webroot="web";
+distribution_profile_repo="drupal/cms";
+distribution_project_template="drupal/cms";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-drupalcms2-x-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal CMS 2.x
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="^2";
+
+# Distribution.
+distribution_name="drupal_cms";
+distribution_title="Drupal CMS";
+distribution_webroot="web";
+distribution_profile_repo="drupal/cms";
+distribution_project_template="drupal/cms";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-odoo20-project.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# workspace-name: Odoo 20 Community
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="20.0";
+
+ARGPARSE_DESCRIPTION="Build an Odoo Community project, on PostgreSQL"
+source ${WORKSPACE_SCRIPTS}/args/arg-odoo.sh || exit 1 ;
+
+shift $#;
+
+build_odoo ;

package/commands/cmd-tools-add-users.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Add users to a project"
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+parser.add_argument('DISTRIBUTION_NAME',
+                    help='The name of the user list for the profile.')
+EOF
+
+shift $#;
+trim_project_name ;   # "v11x00b1/" -> "v11x00b1" — see functions/fun-project-name.sh
+
+distribution_name=${DISTRIBUTION_NAME};
+
+add_users ${PROJECT_NAME} ${distribution_name};

package/commands/cmd-tools-backup-sandboxes.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Backup a sandboxes project"
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+EOF
+
+shift $#;
+trim_project_name ;   # "v11x00b1/" -> "v11x00b1" — see functions/fun-project-name.sh
+
+backup_workspace_item "${PROJECT_NAME}" || exit 1 ;
+(cd ${PROJECT_NAME} && ddev export-db --file=${backups}/${doc_name}/${doc_name}---${PROJECT_NAME}--${BACKUP_TIME}-db.sql.gz) ;

package/commands/cmd-tools-cancel-users.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Cancle users from a project and delete their content"
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+parser.add_argument('DISTRIBUTION_NAME',
+                    help='The name of the user list for the profile.')
+EOF
+
+shift $#;
+trim_project_name ;   # "v11x00b1/" -> "v11x00b1" — see functions/fun-project-name.sh
+
+distribution_name=${DISTRIBUTION_NAME};
+
+cancel_users ${PROJECT_NAME} ${distribution_name};

package/commands/cmd-tools-checks.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+
+# Run the code-quality checks a package in this workspace already declares in its package.json —
+# lint:js, lint:css, lint:yaml, spellcheck, phpcs, and the browser suite — mapped onto one set of
+# canonical names so the command means the same thing in every workspace.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Run the code-quality checks a sandboxes item already declares"
+source ${WORKSPACE_SCRIPTS}/args/arg-checks.sh || exit 1 ;
+
+shift $#;
+
+checks_command ;

package/commands/cmd-tools-clone.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# Clone a project — folder and database — into a new name, in this workspace or
+# another one. The clone becomes an independent DDEV project with its own name,
+# containers and database; the source is never modified.
+#
+#   bash cmd-tools-clone.sh <project> --to <name>
+#   bash cmd-tools-clone.sh <project> --to <name> --target-workspace sandboxes
+#
+# When the project is a git checkout it can be cloned as a git WORKTREE instead:
+# one shared .git and one history, a branch per folder, and still its own DDEV
+# project at its own URL with its own database.
+#
+#   bash cmd-tools-clone.sh <project> --to <name> --worktree
+#   bash cmd-tools-clone.sh <project> --to <name> --worktree --branch 3512345-the-fix
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+ARGPARSE_DESCRIPTION="Clone a project (folder + database) into a new name, here or in another workspace"
+source ${WORKSPACE_SCRIPTS}/args/arg-clone.sh || exit 1 ;
+
+shift $#;
+
+clone_project ;

package/commands/cmd-tools-hostnames.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+
+# workspace-name: Hostnames (extra domains)
+#
+# What a project answers at, and how to give it another address.
+#
+# A DDEV project's URL comes from its NAME (`<name>.ddev.site`), and the dashboard
+# hands out a second, hierarchical one (`<project>.sandboxes.workspace.ddev.site`).
+# This adds a THIRD shape: a flat hostname of your choosing, so the same project
+# name in two workspaces can be told apart —
+# `test3-sandboxes.ddev.site` beside `test3-test.ddev.site`.
+#
+# It ADDS rather than renames. Renaming a DDEV project kills the old URL,
+# recreates its containers and volumes, and leaves the project name no longer
+# matching the folder — which is what makes a git worktree collide with its
+# source. An extra hostname costs nothing and is reversible.
+#
+#   bash cmd-tools-hostnames.sh                                  # every project here
+#   bash cmd-tools-hostnames.sh myproject                        # just this one
+#   bash cmd-tools-hostnames.sh myproject --with-workspace --start
+#   bash cmd-tools-hostnames.sh myproject --add staging --start
+#   bash cmd-tools-hostnames.sh myproject --remove staging
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="What a project answers at, and how to add another address"
+source ${WORKSPACE_SCRIPTS}/args/arg-hostnames.sh || exit 1 ;
+
+shift $#;
+
+cd ${WORKSPACE_ROOT}/${doc_name};
+
+hostnames_command ;

package/commands/cmd-tools-reclaim.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+
+# Reclaim the disk that REMOVED projects left behind — their DDEV databases, snapshots, built images
+# and containers. A project whose folder is still on disk is never touched, stopped or not.
+#
+# The sweep is machine-wide wherever you run it: it takes no project name, reads WORKSPACE_ROOT, and
+# protects every project folder in the tree — so this copy behaves identically to the one in any other
+# workspace. It ships in each workspace that leans on DDEV, graphify or RAG for the same reason
+# cmd-tools-graphify.sh does: the folder you are standing in is where you look for a cmd-tools-*.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Reclaim disk from projects that no longer have a folder — dry run unless --apply"
+source ${WORKSPACE_SCRIPTS}/args/arg-reclaim.sh || exit 1 ;
+
+shift $#;
+
+reclaim_command ;

package/commands/cmd-tools-remove.sh

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+
+ARGPARSE_DESCRIPTION="Remove a project"
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    default='_none_',
+                    nargs='?',
+                    help='The name of the project.')
+parser.add_argument('-o', '--orphans',
+                    action='store_true',
+                    default=False,
+                    help='List DDEV entries whose project directory is gone, instead of removing anything.')
+parser.add_argument('-f', '--force',
+                    action='store_true',
+                    default=False,
+                    help='Remove even when the folder is the main git checkout other worktrees depend on, or holds commits and changes that are on no remote. Both are refused without it.')
+parser.add_argument('-b', '--backup',
+                    action='store_true',
+                    default=False,
+                    help='Export the database into backups/ before anything is deleted. Off by default: a remove is a remove.')
+EOF
+
+shift $#;
+trim_project_name ;   # "v11x00b1/" -> "v11x00b1" — see functions/fun-project-name.sh
+
+
+# Change directory to the workspace for this full operation.
+cd ${WORKSPACE_ROOT}/${doc_name};
+
+if [ "${ORPHANS}" == 'yes' ] ; then
+  report_orphans ;
+elif [ "${PROJECT_NAME}" == '_none_' ] ; then
+  echo "Name the project to remove, or pass --orphans to see DDEV entries with no directory." ;
+  exit 1 ;
+else
+  remove_project "${PROJECT_NAME}" || exit 1 ;
+fi

package/commands/cmd-tools-screen.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# Run anything in a detached screen session that survives terminal exits and
+# dashboard restarts, with a log the dashboard's Screens modal can follow.
+#
+#   bash cmd-tools-screen.sh --list
+#   bash cmd-tools-screen.sh build-demo1 --run "bash cmd-webship11-0-x-project.sh demo1 --install"
+#   bash cmd-tools-screen.sh build-demo1 --follow
+#   bash cmd-tools-screen.sh build-demo1 --stop
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+ARGPARSE_DESCRIPTION="Run and manage detached screen sessions with dashboard-followable logs"
+source ${WORKSPACE_SCRIPTS}/args/arg-screen.sh || exit 1 ;
+
+shift $#;
+
+screen_command ;

package/commands/cmd-tools-testing.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+# Set up the automated-testing environment on an existing project in this workspace, or run its
+# suite. Both happen inside DDEV.
+#
+# Unlike test/cmd-automated-testing-*-project.sh, this never builds a site from nothing and never
+# deletes anything: it applies the testing stack to a project that is already here.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Configure the automated-testing environment of a sandboxes project, or run its suite"
+source ${WORKSPACE_SCRIPTS}/args/arg-testing.sh || exit 1 ;
+
+shift $#;
+
+testing_command ;

package/commands/cmd-tools-update-all.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+cd ${WORKSPACE_ROOT}/${doc_name};
+echo "=======================================================";
+echo "  Update all projects in ${WORKSPACE_ROOT}/${doc_name} ";
+echo "=======================================================";
+for project in *; do
+    if [ -d "$project" ]; then
+        echo "  $project   ";
+    fi;
+done;
+for project in *; do
+    if [ -d "$project" ]; then
+        echo "=======================================================";
+        echo "  ${WORKSPACE_ROOT}/${doc_name}/${project}/   ";
+        echo "=======================================================";
+        cd ${WORKSPACE_ROOT}/${doc_name}/${project};
+        yes | composer update -v;
+    fi;
+    cd ${WORKSPACE_ROOT}/${doc_name}
+done;

package/commands/cmd-webship11-0-0-project.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+# workspace-name: Webship 11.0.0
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version.
+# The 11.0.0 line. Named down to the release candidate on purpose: rc1 is the only
+# release published so far, and a constraint of "~11.0" cannot select it under stable
+# stability — create-project fails outright. This picks up 11.0.0 as soon as it is tagged.
+site_version="~11.0.0-rc1";
+
+# Distribution.
+distribution_name="webship";
+distribution_title="Webship";
+distribution_webroot="web";
+distribution_profile_repo="drupal/webship";
+distribution_project_template="drupal/webship_project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-webship11-0-x-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Webship 11.0.x
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version.
+site_version="11.0.x-dev";
+
+# Distribution.
+distribution_name="webship";
+distribution_title="Webship";
+distribution_webroot="web";
+distribution_profile_repo="drupal/webship";
+distribution_project_template="drupal/webship_project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-webships2-0-0-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Webships 2.0.0
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version.
+site_version="~2.0";
+
+# Distribution.
+distribution_name="webships";
+distribution_title="Webships";
+distribution_webroot="web";
+distribution_profile_repo="webship/webships";
+distribution_project_template="webship/webships-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-webships2-0-x-project.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+
+# workspace-name: Webships 2.0.x
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version.
+site_version="2.0.x-dev";
+
+# Distribution.
+distribution_name="webships";
+distribution_title="Webships";
+distribution_webroot="web";
+distribution_profile_repo="webship/webships";
+distribution_project_template="webship/webships-project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} ${site_version} project"
+source ${WORKSPACE_SCRIPTS}/args/arg-${distribution_name}.sh || exit 1 ;
+
+shift $#;
+
+# Build the distribution.
+build_distribution ;

package/commands/cmd-webships3-0-x-project.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+
+# workspace-name: Webships 3.0.x
+
+# Build a Webships 3.0.x API site with DDEV: the Webships Project template, the
+# Webships installer, and one API site template.
+# https://www.drupal.org/project/webships
+#
+#   bash cmd-webships3-0-x-project.sh myapi --install
+#   bash cmd-webships3-0-x-project.sh myapi --install --template webapi_starter --add-users
+#
+# The installer profile is on 3.0.x while the project template is on 1.0.x: the two
+# lines are deliberately not in lockstep, so `site_version` below is the version of
+# the PROJECT TEMPLATE, which is what `composer create-project` receives. The 3.0.x
+# profile arrives through the template's own `webship/webships: ^3` constraint.
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings and extra lists.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set the version of the project template.
+site_version="1.0.x-dev";
+
+# Distribution.
+distribution_name="webships";
+distribution_title="Webships";
+distribution_webroot="web";
+distribution_profile_repo="webship/webships";
+distribution_project_template="drupal/webships_project";
+
+ARGPARSE_DESCRIPTION="Build a ${distribution_title} 3.0.x API project, installed with the Webships installer"
+source ${WORKSPACE_SCRIPTS}/args/arg-webships-project.sh || exit 1 ;
+
+shift $#;
+
+build_webships_project ;

package/commands/cmd-wordpress-project.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# workspace-name: WordPress (latest)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="latest";
+wordpress_shape="core";
+ARGPARSE_DESCRIPTION="Build a WordPress project, the latest release"
+source ${WORKSPACE_SCRIPTS}/args/arg-wordpress.sh || exit 1 ;
+
+shift $#;
+
+build_wordpress ;

package/commands/cmd-wpbedrock1-project.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+# workspace-name: WordPress on Composer (Bedrock ^1)
+
+# Bootstrap.
+# Find the workspace tooling from this script, so a fresh clone needs no setup.
+WORKSPACE_SCRIPTS="${WORKSPACE_SCRIPTS:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../core/scripts" && pwd)}";
+source ${WORKSPACE_SCRIPTS}/bootstrap.sh || exit 1 ;
+
+# Load workspace settings.
+eval $(parse_yaml ${WORKSPACE_CONFIG}/workspace.sandboxes.settings.yml);
+
+# Set site version.
+site_version="^1";
+wordpress_shape="bedrock";
+ARGPARSE_DESCRIPTION="Build a WordPress project managed by Composer, on roots/bedrock"
+source ${WORKSPACE_SCRIPTS}/args/arg-wordpress.sh || exit 1 ;
+
+shift $#;
+
+build_wordpress ;

package/config/workspace.sandboxes.settings.yml

@@ -0,0 +1,17 @@
+doc:
+  name: sandboxes
+
+# What this folder's projects are, and which actions their rows offer:
+# sites | code | files | media | ai-items — see core/workspace-app/WORKSPACES.md.
+type: sites
+
+# What the COMPOSER menu may do here: full | manifest (the default). A site workspace is full:
+# install, update, scripts and the rest, run in screens through ddev composer.
+composer: full
+
+# What the assistant is called on THIS workspace's page, and what its composer says when empty.
+# `default` in either means "whatever settings.yml says" — the global value, so a rename there
+# still reaches this page. Set a value here to override it for this workspace alone.
+assistant:
+  name: default
+  placeholder: default

package/dist/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The Sandboxes workspace for Webship Workspace: the `sandboxes/` folder as a plugin.
+ *
+ * What the package carries is placed by the installer from the manifest (the folder's settings file,
+ * its commands and its docs) and listed by --activate; the dashboard draws the workspace from the
+ * settings file like any other. Nothing to register at run time yet: this is where the folder's own
+ * rail buttons, row menus or assistant context would go.
+ */
+import type { PluginApi } from '@webship.co/workspace-plugin-api';
+export declare const WORKSPACE_KEY = "sandboxes";
+export declare function register(api: PluginApi): void;

package/dist/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * The Sandboxes workspace for Webship Workspace: the `sandboxes/` folder as a plugin.
+ *
+ * What the package carries is placed by the installer from the manifest (the folder's settings file,
+ * its commands and its docs) and listed by --activate; the dashboard draws the workspace from the
+ * settings file like any other. Nothing to register at run time yet: this is where the folder's own
+ * rail buttons, row menus or assistant context would go.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKSPACE_KEY = void 0;
+exports.register = register;
+exports.WORKSPACE_KEY = 'sandboxes';
+function register(api) {
+    api.addAssistantContext(() => `The sandboxes/ workspace is the Sandboxes workspace (a plugin, @webship.co/workspace-sandboxes); its commands are the cmd-*.sh scripts in that folder.`);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAMH,4BAEC;AAJY,QAAA,aAAa,GAAG,WAAW,CAAC;AAEzC,SAAgB,QAAQ,CAAC,GAAc;IACrC,GAAG,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,wJAAwJ,CAAC,CAAC;AAC1L,CAAC"}

package/docs/AGENTS.md

@@ -0,0 +1,52 @@
+# Sandboxes
+
+Throwaway experiments. Nothing here is expected to survive.
+
+Part of the **Webship Workspace** (`~/workspace`), a DDEV-only harness. The rules in the root
+`CLAUDE.md` apply here too; what follows is what is specific to this folder.
+
+## The rule that matters here
+
+Everything goes through DDEV. Never a host `composer`, `drush` or `mysql`:
+
+```bash
+ddev composer require drupal/something
+ddev drush cr
+ddev export-db --file=…        # not mysqldump
+ddev delete -y -O              # not a dropped database
+```
+
+`ddev start` takes `-y`; **`ddev stop` does not**. Never write a `$databases` block into
+`settings.php` — DDEV's `settings.ddev.php` owns the connection.
+
+## Commands here
+
+```bash
+bash cmd-cucumber11-0-x-project.sh                     # Cucumber 11.0.x
+bash cmd-drupal10-3-x-recommended-project.sh          # Drupal 10.3.x (recommended project)
+bash cmd-drupal10-recommended-project.sh              # Drupal 10 (recommended project)
+bash cmd-drupal11-0-x-recommended-project.sh          # Drupal 11.0.x (recommended project)
+bash cmd-drupal11-4-0-recommended-project.sh          # Drupal 11.4.0 (recommended project)
+bash cmd-drupal11-4-x-recommended-project.sh          # Drupal 11.4.x (recommended project)
+bash cmd-drupal11-recommended-project.sh              # Drupal 11 (recommended project)
+bash cmd-drupal9-recommended-project.sh               # Drupal 9 (recommended project)
+bash cmd-drupalcms2-1-0-project.sh                    # Drupal CMS 2.1.0
+bash cmd-drupalcms2-x-project.sh                      # Drupal CMS 2.x
+bash cmd-tools-add-users.sh                           # Bootstrap.
+bash cmd-tools-backup-sandboxes.sh                    # Bootstrap.
+bash cmd-tools-cancel-users.sh                        # Bootstrap.
+bash cmd-tools-git-change-filemode-to-false.sh        # Bootstrap.
+bash cmd-tools-graphify.sh                            # Map a project in this workspace into a queryable knowledge graph with
+bash cmd-tools-obsidian.sh                             # Turn a project graph into an Obsidian vault
+bash cmd-tools-ragify.sh                              # Index a project in this workspace into the Milvus vector database
+bash cmd-tools-remove.sh                              # Bootstrap.
+bash cmd-tools-testing.sh                             # Set up the automated-testing environment on an existing project in this workspace, or run its
+bash cmd-tools-update-all.sh                          # Bootstrap.
+bash cmd-webship11-0-0-project.sh                     # Webship 11.0.0
+bash cmd-webship11-0-x-project.sh                     # Webship 11.0.x
+bash cmd-webships2-0-0-project.sh                     # Webships 2.0.0
+bash cmd-webships2-0-x-project.sh                     # Webships 2.0.x
+```
+
+Every one locates the workspace from its own path, so there is nothing to export and nothing to
+install. `--help` on any of them lists its arguments.

package/docs/CLAUDE.md

@@ -0,0 +1,7 @@
+# Sandboxes — workspace context
+
+You are inside the **sandboxes** workspace of the Webship Workspace (`~/workspace`).
+
+@AGENTS.md
+
+The rules in it apply to everything under this folder, however deep.

package/docs/README.md

@@ -0,0 +1,5 @@
+# Sandboxes
+
+Where we do all sandbox templates, and private custom content work.
+
+

package/features/sandboxes.feature

@@ -0,0 +1,13 @@
+Feature: The Sandboxes workspace plugin
+  Once the plugin is activated and installed, the sandboxes workspace is on the dashboard, and the
+  Plugins page lists the plugin with its four steps.
+
+  Scenario: The workspace page is there
+    Given I am on "/sandboxes"
+     Then the element "h1" should be displayed
+      And the element "#webship-workspace-projects, .items-list, .workspace-page" should be attached
+
+  Scenario: The plugin is listed on the Plugins page
+    Given I am on "/settings/plugins"
+     Then I should see "Sandboxes"
+      And I should see "@webship.co/workspace-sandboxes"

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@webship.co/workspace-sandboxes",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-beta1",
+  "description": "The Sandboxes workspace for Webship Workspace: the `sandboxes/` folder (type sites), its settings file, its 30 commands and its docs, activated as a plugin.",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/webship/workspace-sandboxes.git"
+  },
+  "files": [
+    "dist/src",
+    "commands",
+    "config",
+    "docs",
+    "features",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "test": "npm run build && node --test dist/tests/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "workspacePlugin": {
+    "name": "sandboxes",
+    "label": "Sandboxes",
+    "workspace": {
+      "key": "sandboxes",
+      "settingsTemplate": "config/workspace.sandboxes.settings.yml",
+      "files": [
+        "commands/cmd-cucumber11-0-x-project.sh",
+        "commands/cmd-drupal10-3-x-recommended-project.sh",
+        "commands/cmd-drupal10-recommended-project.sh",
+        "commands/cmd-drupal11-0-x-recommended-project.sh",
+        "commands/cmd-drupal11-4-0-recommended-project.sh",
+        "commands/cmd-drupal11-4-x-recommended-project.sh",
+        "commands/cmd-drupal11-recommended-project.sh",
+        "commands/cmd-drupal12-recommended-project.sh",
+        "commands/cmd-drupal9-recommended-project.sh",
+        "commands/cmd-drupalcms2-1-0-project.sh",
+        "commands/cmd-drupalcms2-x-project.sh",
+        "commands/cmd-odoo20-project.sh",
+        "commands/cmd-tools-add-users.sh",
+        "commands/cmd-tools-backup-sandboxes.sh",
+        "commands/cmd-tools-cancel-users.sh",
+        "commands/cmd-tools-checks.sh",
+        "commands/cmd-tools-clone.sh",
+        "commands/cmd-tools-hostnames.sh",
+        "commands/cmd-tools-reclaim.sh",
+        "commands/cmd-tools-remove.sh",
+        "commands/cmd-tools-screen.sh",
+        "commands/cmd-tools-testing.sh",
+        "commands/cmd-tools-update-all.sh",
+        "commands/cmd-webship11-0-0-project.sh",
+        "commands/cmd-webship11-0-x-project.sh",
+        "commands/cmd-webships2-0-0-project.sh",
+        "commands/cmd-webships2-0-x-project.sh",
+        "commands/cmd-webships3-0-x-project.sh",
+        "commands/cmd-wordpress-project.sh",
+        "commands/cmd-wpbedrock1-project.sh"
+      ],
+      "docs": [
+        "docs/AGENTS.md",
+        "docs/CLAUDE.md",
+        "docs/README.md"
+      ]
+    },
+    "features": [
+      "features/sandboxes.feature"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@webship.co/workspace-plugin-api": "^1.0.0-beta1",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}