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

package/README.md

@@ -1,3 +1,39 @@
-# Temporary Holding Version
+# @webship.co/workspace-drupal-themes
 
-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 **Drupal themes** workspace of the [Webship Workspace](https://github.com/webship/workspace) dashboard:
+the `themes/` folder (type `code`), its settings file (`core/config/workspace.themes.settings.yml`),
+its commands and its docs, as a plugin.
+
+## Use it
+
+```bash
+cd ~/workspace
+bash core/scripts/plugins.sh --require github:webship/workspace-drupal-themes
+bash core/scripts/plugins.sh --activate drupal-themes     # puts `themes` on the workspaces list of settings.yml
+bash core/scripts/plugins.sh --install drupal-themes      # 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-all-back-end-build-themes.sh` |
+| `cmd-all-back-end-install-themes.sh` |
+| `cmd-all-front-end-build-themes.sh` |
+| `cmd-all-front-end-install-themes.sh` |
+| `cmd-backup-theme.sh` |
+| `cmd-build-admin-theme.sh` |
+| `cmd-build-drupal-template.sh` |
+| `cmd-build-theme.sh` |
+| `cmd-install-admin-theme.sh` |
+| `cmd-install-theme.sh` |
+| `cmd-tools-checks.sh` |
+| `cmd-tools-gitlab-ci-local.sh` |
+| `cmd-tools-reclaim.sh` |
+| `cmd-tools-remove.sh` |
+| `cmd-tools-update-all.sh` |
+
+The bash functions these commands call live in the dashboard's `core/scripts/functions`.

package/commands/cmd-all-back-end-build-themes.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+
+ARGPARSE_DESCRIPTION="Build every back-end admin theme listed in workspace.themes.settings.yml."
+
+echo "*-----------------------------------------------------------*";
+echo "| Build all Back-End admin themes                           |";
+echo "*-----------------------------------------------------------*";
+echo "| ${WORKSPACE_CONFIG}/workspace.themes.settings.yml";
+echo "*-----------------------------------------------------------*"
+
+current_path=$(pwd);
+
+# 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.themes.settings.yml);
+
+# Refuse to run with an empty name. `rm -rf ${WORKSPACE_ROOT}/themes/${name}` with an unset name
+# deletes the whole themes workspace, which is what the old `vdo_`-prefixed settings key caused:
+# it flattened to a different variable than the one read here, so this was empty every time.
+if [ -z "${drupal_template_drupal_theme_name}" ] ; then
+  echo "drupal.template_drupal_theme_name is not set in core/config/workspace.themes.settings.yml — refusing to run." ;
+  exit 1 ;
+fi
+
+
+cd ${WORKSPACE_ROOT}/themes/ ;
+
+# Delete old Admin themes.
+for admin_theme_name in "${admin_themes[@]}"
+do
+  sudo rm -rf ${WORKSPACE_ROOT}/themes/${admin_theme_name};
+done
+
+
+cd ${WORKSPACE_ROOT}/themes/ ;
+
+sudo rm -rf ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+composer create-project drupal/recommended-project:~9.0 ${drupal_template_drupal_theme_name} --stability dev --no-interaction ;
+
+
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+
+
+# Build all admin themes in the admin theme list.
+for admin_theme_name in "${admin_themes[@]}"
+do
+  cd ${WORKSPACE_ROOT}/themes/ ;
+  . cmd-build-admin-theme.sh ${admin_theme_name};
+done
+
+# Change file mod and owner.
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/ ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/ ;
+

package/commands/cmd-all-back-end-install-themes.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+ARGPARSE_DESCRIPTION="Install every back-end admin theme listed in workspace.themes.settings.yml into the template project."
+
+echo "*-----------------------------------------------------------*";
+echo "| Install all Back-End admin themes                         |";
+echo "*-----------------------------------------------------------*";
+echo "| ${WORKSPACE_CONFIG}/workspace.themes.settings.yml";
+echo "*-----------------------------------------------------------*"
+
+current_path=$(pwd);
+
+# 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.themes.settings.yml);
+
+# Change file mod and owner.
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/ ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/ ;
+
+# Install all admin themes in the admin theme list.
+for admin_theme_name in "${admin_themes[@]}"
+do
+  cd "${WORKSPACE_ROOT}/themes/" ;
+  . cmd-install-admin-theme.sh ${admin_theme_name} ;
+done

package/commands/cmd-all-front-end-build-themes.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+
+ARGPARSE_DESCRIPTION="Build every front-end theme listed in workspace.themes.settings.yml."
+
+echo "*-----------------------------------------------------------*";
+echo "| Build all Front-End themes                                |";
+echo "*-----------------------------------------------------------*";
+echo "| ${WORKSPACE_CONFIG}/workspace.themes.settings.yml";
+echo "*-----------------------------------------------------------*"
+
+current_path=$(pwd);
+
+# 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.themes.settings.yml);
+
+# Refuse to run with an empty name. `rm -rf ${WORKSPACE_ROOT}/themes/${name}` with an unset name
+# deletes the whole themes workspace, which is what the old `vdo_`-prefixed settings key caused:
+# it flattened to a different variable than the one read here, so this was empty every time.
+if [ -z "${drupal_template_drupal_theme_name}" ] ; then
+  echo "drupal.template_drupal_theme_name is not set in core/config/workspace.themes.settings.yml — refusing to run." ;
+  exit 1 ;
+fi
+
+
+cd ${WORKSPACE_ROOT}/themes/ ;
+
+# Delete old themes.
+for theme_name in "${themes[@]}"
+do
+  sudo rm -rf ${WORKSPACE_ROOT}/themes/${theme_name};
+done
+
+cd ${WORKSPACE_ROOT}/themes/ ;
+
+sudo rm -rf ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+composer create-project drupal/recommended-project:~9.0 ${drupal_template_drupal_theme_name} --stability dev --no-interaction ;
+
+
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+
+# Build all themes in the themes list.
+for theme_name in "${themes[@]}"
+do
+  cd ${WORKSPACE_ROOT}/themes/ ;
+  . cmd-build-theme.sh ${theme_name};
+done
+
+# Change file mod and owner.
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/ ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/ ;
+

package/commands/cmd-all-front-end-install-themes.sh

@@ -0,0 +1,30 @@
+#!/usr/bin/env bash
+
+ARGPARSE_DESCRIPTION="Install every front-end theme listed in workspace.themes.settings.yml into the template project."
+
+echo "*-----------------------------------------------------------*";
+echo "| Install all Front-End themes                              |";
+echo "*-----------------------------------------------------------*";
+echo "| ${WORKSPACE_CONFIG}/workspace.themes.settings.yml";
+echo "*-----------------------------------------------------------*"
+
+current_path=$(pwd);
+
+# 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.themes.settings.yml);
+
+# Change file mod and owner.
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/ ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/ ;
+
+# Install all themes in the themes list.
+for theme_name in "${themes[@]}"
+do
+  cd "${WORKSPACE_ROOT}/themes/" ;
+  . cmd-install-theme.sh ${theme_name} ;
+done

package/commands/cmd-backup-theme.sh

@@ -0,0 +1,22 @@
+#!/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.themes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Backup a theme"
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the theme.')
+EOF
+
+shift $#;
+trim_project_name ;   # "v11x00b1/" -> "v11x00b1" — see functions/fun-project-name.sh
+
+backup_time=$( date '+%Y-%m-%d_%H-%M-%S' );
+tar -cvzf ${backups}/${doc_name}/${doc_name}---${PROJECT_NAME}--${backup_time}.tar.gz ${PROJECT_NAME} ;
+(cd ${PROJECT_NAME} && ddev export-db --file=${backups}/${doc_name}/${doc_name}---${PROJECT_NAME}--${backup_time}-db.sql.gz) ;

package/commands/cmd-build-admin-theme.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# workspace-name: Admin Theme
+
+# 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.themes.settings.yml);
+
+# GET the project name argument.
+if [ "$1" != "" ]; then
+    theme_name=$1;
+else
+  echo "Please add the name of your theme.";
+  exit 1;
+fi
+
+echo "*-----------------------------------------------------------*";
+echo "| Build ${theme_name}";
+echo "*-----------------------------------------------------------*";
+
+cp -r ${drupal_template_drupal_theme_name} ${WORKSPACE_ROOT}/themes/${theme_name} ;
+cd ${WORKSPACE_ROOT}/themes/${theme_name} ;
+composer require drupal/${theme_name} ;

package/commands/cmd-build-drupal-template.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+# workspace-name: Drupal template
+
+echo "*-----------------------------------------------------------*";
+echo "|  Build Drupal template                                    |";
+echo "*-----------------------------------------------------------*";
+
+current_path=$(pwd);
+
+# 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.themes.settings.yml);
+
+# Refuse to run with an empty name. `rm -rf ${WORKSPACE_ROOT}/themes/${name}` with an unset name
+# deletes the whole themes workspace, which is what the old `vdo_`-prefixed settings key caused:
+# it flattened to a different variable than the one read here, so this was empty every time.
+if [ -z "${drupal_template_drupal_theme_name}" ] ; then
+  echo "drupal.template_drupal_theme_name is not set in core/config/workspace.themes.settings.yml — refusing to run." ;
+  exit 1 ;
+fi
+
+
+cd ${WORKSPACE_ROOT}/themes/ ;
+
+sudo rm -rf ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+composer create-project drupal/recommended-project:~9.0 ${drupal_template_drupal_theme_name} --stability dev --no-interaction ;
+
+
+sudo chmod 775 -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;
+sudo chown www-data:${USER} -R ${WORKSPACE_ROOT}/themes/${drupal_template_drupal_theme_name} ;

package/commands/cmd-build-theme.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# workspace-name: Theme
+
+# 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.themes.settings.yml);
+
+# GET the project name argument.
+if [ "$1" != "" ]; then
+    theme_name=$1;
+else
+  echo "Please add the name of your theme.";
+  exit 1;
+fi
+
+echo "*-----------------------------------------------------------*";
+echo "| Build ${theme_name}";
+echo "*-----------------------------------------------------------*";
+
+cp -r ${drupal_template_drupal_theme_name} ${WORKSPACE_ROOT}/themes/${theme_name} ;
+cd ${WORKSPACE_ROOT}/themes/${theme_name} ;
+composer require drupal/${theme_name} ;

package/commands/cmd-install-admin-theme.sh

@@ -0,0 +1,40 @@
+#!/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.themes.settings.yml);
+
+# GET the project name argument.
+if [ "$1" != "" ]; then
+    theme_name=$1;
+else
+  echo "Please add the name of your theme.";
+  exit 1;
+fi
+
+echo "*-----------------------------------------------------------*";
+echo "| Install ${theme_name}";
+echo "*-----------------------------------------------------------*";
+
+
+
+cd "${WORKSPACE_ROOT}/themes/${theme_name}/web";
+
+ddev drush site-install standard --yes \
+--site-name="Theme ${theme_name}" \
+--account-name="${account_name}" \
+--account-pass="${account_pass}" \
+--account-mail="${account_mail}" \
+--db-url="mysql://db:db@db/db" ;
+
+ddev drush config-set system.performance css.preprocess 0 --yes ;
+ddev drush config-set system.performance js.preprocess 0 --yes ;
+ddev drush config-set system.logging error_level all --yes ;
+ddev drush cr ;
+
+ddev drush theme-enable ${theme_name} ;
+ddev drush config-set system.theme admin ${theme_name} --yes ;

package/commands/cmd-install-theme.sh

@@ -0,0 +1,45 @@
+#!/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.themes.settings.yml);
+
+# GET the project name argument.
+if [ "$1" != "" ]; then
+    theme_name=$1;
+else
+  echo "Please add the name of your theme.";
+  exit 1;
+fi
+
+echo "*-----------------------------------------------------------*";
+echo "| Install ${theme_name}";
+echo "*-----------------------------------------------------------*";
+
+
+
+cd "${WORKSPACE_ROOT}/themes/${theme_name}/web";
+
+ddev drush site-install standard --yes \
+--site-name="Theme ${theme_name}" \
+--account-name="${account_name}" \
+--account-pass="${account_pass}" \
+--account-mail="${account_mail}" \
+--db-url="mysql://db:db@db/db" ;
+
+ddev drush config-set system.performance css.preprocess 0 --yes ;
+ddev drush config-set system.performance js.preprocess 0 --yes ;
+ddev drush config-set system.logging error_level all --yes ;
+ddev drush cr ;
+
+ddev drush theme-enable ${theme_name} ;
+ddev drush config-set system.theme default ${theme_name} --yes ;
+ddev drush config-set system.theme admin seven --yes ;
+
+
+
+

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.themes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Run the code-quality checks a themes item already declares"
+source ${WORKSPACE_SCRIPTS}/args/arg-checks.sh || exit 1 ;
+
+shift $#;
+
+checks_command ;

package/commands/cmd-tools-gitlab-ci-local.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+# Run a project's GitLab CI pipeline locally with gitlab-ci-local — the Webship
+# green-gate before any push to git.drupalcode.org. Wires the
+# drupal/gitlab_templates remote variables through the drupal-ci-local wrapper
+# (installed on first run), checks Docker and SSH, and reports GREEN/RED.
+
+# 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.themes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Run a themes project's GitLab CI pipeline locally (the green-gate)"
+source ${WORKSPACE_SCRIPTS}/args/arg-gitlab-ci-local.sh || exit 1 ;
+
+shift $#;
+
+if [ "${DOCTOR}" == 'yes' ] ; then
+  gitlab_ci_local_doctor && echo "Everything a green-gate run needs is in place." ;
+else
+  gitlab_ci_local_run ;
+fi

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.themes.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,42 @@
+#!/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.themes.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('-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('-o', '--orphans',
+                    action='store_true',
+                    default=False,
+                    help='List DDEV entries whose project directory is gone, instead of removing anything.')
+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-update-all.sh

@@ -0,0 +1,17 @@
+# 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.themes.settings.yml);
+
+for project in *; do
+    if [ -d "$project" ]; then
+    echo "===========================================";
+    echo "  $project";
+    echo "===========================================";
+	cd ${WORKSPACE_ROOT}/${doc_name}/${project};
+	composer update --no-interaction  ;
+    fi
+done

package/config/workspace.themes.settings.yml

@@ -0,0 +1,482 @@
+doc:
+  name: themes
+# The scratch project the theme builders create and destroy. The key name matters: parse_yaml
+# flattens it to $drupal_template_drupal_theme_name, which is the variable those scripts read.
+drupal:
+  template_drupal_theme_name: template_drupal
+themes:
+  - flexi_pattern_lab
+  - zilch
+  - abeesparadise
+  - abovolab
+  - adaptivetheme
+  - aegan
+  - material
+  - agov_base
+  - agov_nsw
+  - agov_whitlam
+  - amazeui
+  - amptheme
+  - architect
+  - arriaga
+  - awesome
+  - awesome_zymphonies_theme
+  - badcamp_sight
+  - bank_zymphonies_theme
+  - barnettechetjlb
+  - bootstrap_barrio
+  - base_zymphonies_theme
+  - basic
+  - bassline
+  - bealestreet
+  - bear_skin
+  - beauty_salon_zymphonies_theme
+  - beep_edition
+  - beginning
+  - belgrade
+  - belle
+  - bem
+  - beryllium
+  - blocky
+  - blogz
+  - blueadmino
+  - bluemarine
+  - bluemasters
+  - bones_theme
+  - bon_voyage
+  - bootbase
+  - bootstrap
+  - bootstrap_sass
+  - bootstrapblog
+  - bootstrap_business
+  - bootstrap_clean_blog
+  - bootstrap_forms
+  - bootstrap_light
+  - bootstrap_lite
+  - bootstrap_mint
+  - bootstrap_pointnet
+  - rainbow
+  - bootstrap_rijkshuisstijl
+  - bootstrap_subtheme_rtl
+  - bootstrap4
+  - bootstrapper
+  - bourbon
+  - boxes_uikitty
+  - breeze
+  - bridge
+  - bs_base
+  - bt_theme
+  - bulma
+  - business
+  - businessgroup_zymphonies_theme
+  - business_listing_zymphonies_theme
+  - business_responsive_theme
+  - businessplus_lite
+  - busy
+  - byu_amp_theme
+  - byu_theme
+  - camaleon
+  - car_zymphonies_theme
+  - casper
+  - champs_base
+  - charity_zymphonies_theme
+  - cherryblossom
+  - civi_bartik
+  - claro
+  - classa11y
+  - d8_blog_theme
+  - clean_blog
+  - clinic_zymphonies_theme
+  - cloud_zymphonies_theme
+  - cog
+  - colonel
+  - coloradmin
+  - commerce_bootstrap
+  - uikitty_components
+  - concedra_theme
+  - conference_lite
+  - contacts_theme
+  - corolla
+  - corporate_corp_theme
+  - corporate_lite
+  - corporate_blue
+  - corporation
+  - creative_theme
+  - creative_responsive_theme
+  - stem_theme
+  - creativity
+  - credit_due
+  - da_vinci
+  - danland
+  - dawn
+  - designer
+  - devblog
+  - dg_theme
+  - diba_core
+  - dopetrope
+  - drulma
+  - drumob
+  - drupal8_custom_theme
+  - drupal8_parallax_theme
+  - premier_league
+  - drupal_light
+  - d8w3css
+  - drupal8_zymphonies_theme
+  - drupalcoders_bootstrap
+  - drupalexp_lite
+  - druppio_monopage
+  - druppio_small_business
+  - easy_news
+  - ebiz
+  - ebook_zymphonies_theme
+  - edynamic_theme
+  - eight
+  - electra
+  - eleven
+  - ember
+  - empty_theme
+  - emulsify
+  - estore
+  - everest
+  - exsen
+  - fepper
+  - flame
+  - flexi
+  - flexible
+  - flow2
+  - fontfolio
+  - form3
+  - fortytwo
+  - foundation_patterns
+  - foundation6
+  - fusion
+  - garland
+  - gesso
+  - glisseo
+  - gogland
+  - gordon
+  - govuk_design_system
+  - govcms8_uikit_starter
+  - govcms8_ui
+  - gratis
+  - great_zymphonies_theme
+  - green_theme
+  - guesthouse_lite
+  - guru
+  - helios_responsive
+  - himalaya
+  - holy
+  - hwc
+  - hops
+  - hotbed
+  - icemagic
+  - ideastorm
+  - iu
+  - industrial_zymphonies_theme
+  - insha
+  - integrity
+  - intercept_base
+  - isosceles_theme
+  - janitor
+  - jethro
+  - jouve_seven
+  - kalatheme
+  - kanji
+  - kashmir
+  - kaziranga
+  - khan
+  - lab
+  - landingpage_zymphonies_theme
+  - law_firm_theme
+  - liberty
+  - light_skeleton
+  - light_zymphonies_theme
+  - likable
+  - litejazz
+  - louie
+  - magazine_lite
+  - management
+  - marinelli
+  - matter
+  - material_base
+  - material_corporate
+  - mdc
+  - materialize
+  - mayo
+  - mbase
+  - medicare_zymphonies_theme
+  - mediteran
+  - medium_theme
+  - mediumish_blog
+  - menuistic
+  - mili
+  - milligram
+  - minima
+  - minimal
+  - mdb
+  - minimal_lite
+  - minimax
+  - mobidic
+  - mobile
+  - mobileapp_zymphonies_theme
+  - mono
+  - moonwalk
+  - mulpo
+  - multipurpose_corporate_theme
+  - musicians
+  - mytheme
+  - neato
+  - nebula
+  - nebula_demo
+  - nebula_example
+  - neon
+  - nero
+  - news_zymphonies_theme
+  - newsflash
+  - newsplus_lite
+  - nexus
+  - nightar
+  - nigraphic
+  - ninesixty
+  - nitty
+  - nittygritty
+  - addweb_drupal_back_end_theme
+  - noor
+  - octavia
+  - black_old
+  - om
+  - ombak
+  - omega
+  - onepage_zymphonies_theme
+  - onescreen
+  - openchurch_theme
+  - os_base
+  - paper
+  - paraboot
+  - paragon_adminkit
+  - paragon_themekit
+  - particle_responsive
+  - patternlab
+  - paxton
+  - blog_theme
+  - pets_zymphonies_theme
+  - photo
+  - photographer
+  - pistachio
+  - pixels
+  - pixture_reloaded
+  - platinum
+  - platon
+  - portfolio_theme
+  - pragtic
+  - prius
+  - proboci
+  - professional_responsive_theme
+  - professional_theme
+  - property_zymphonies_theme
+  - prototype
+  - qatar_zymphonies_theme
+  - qatar2022_zymphonies_theme
+  - quickseed_theme
+  - quickseed2017gci
+  - quickseedgci
+  - quickseed
+  - radix
+  - reactify
+  - red
+  - release_branch
+  - restaurant_lite
+  - restaurant_zymphonies_theme
+  - robotic
+  - root
+  - sailor
+  - sales_zymphonies_theme
+  - samara
+  - school_zymphonies_theme
+  - searchify
+  - semantica
+  - sensible
+  - seventeen
+  - shakespeare
+  - shiv
+  - shop_item
+  - showcase_lite
+  - classic_corporate_theme
+  - simpleblog
+  - simply
+  - skeletontheme
+  - sketch
+  - smallbusiness
+  - solid
+  - space
+  - spacelift
+  - spatial_theme
+  - spectre
+  - spring_bloom
+  - sshop
+  - stagb
+  - starlight
+  - startupgrowth_lite
+  - startup_zymphonies_theme
+  - store_zymphonies_theme
+  - tailwindcss
+  - tao
+  - tapestry
+  - tara
+  - teacher
+  - teacosy
+  - teatheme
+  - teka
+  - theone
+  - themage
+  - titus
+  - topplus_lite
+  - torsion
+  - travel_zymphonies_theme
+  - treetop
+  - triculin_responsive
+  - tweme
+  - twentyseventeen
+  - twentyfifteen
+  - uswds
+  - uikit
+  - uikitapi
+  - uikit_blog
+  - uikitty
+  - uikitty3
+  - uikitty_starter
+  - umami
+  - used_cars
+  - uswds_base
+  - vartheme
+  - vartheme_bs4
+  - vartheme_material
+  - ven
+  - verti
+  - visually_impaired_theme
+  - void
+  - waterloo
+  - wet4
+  - wxt_bootstrap
+  - webpackrs
+  - webtheme
+  - whitecanvas
+  - whitejazz
+  - windup
+  - wonder_zymphonies_theme
+  - writer
+  - xbase
+  - xseven
+  - xtheme
+  - yeti_theme
+  - yg_aesthetic
+  - yg_agency
+  - yg_app
+  - yg_app_one
+  - yg_architect
+  - yg_asymmetry
+  - yg_biz
+  - yg_black
+  - yg_bold
+  - yg_booster
+  - yg_business
+  - yg_business_line
+  - yg_business_one
+  - yg_business_plus
+  - yg_car_care
+  - yg_charity
+  - yg_concept
+  - yg_construction
+  - yg_construction_lite
+  - yg_corp
+  - yg_corporate
+  - yg_corporate_lite
+  - yg_creative
+  - yg_dentalcare
+  - yg_elate
+  - yg_event_organizer
+  - yg_fitness_center
+  - yg_fitness_gym
+  - yg_flew
+  - yg_flexy
+  - yg_freelancer
+  - yg_glow
+  - yg_greatness
+  - yg_hotel
+  - yg_iconic
+  - yg_insurance
+  - yg_intechnic
+  - yg_interior
+  - yg_justice
+  - yg_launcher
+  - yg_law
+  - yg_law_firm
+  - yg_learn
+  - yg_logistics
+  - yg_magazine
+  - yg_medical
+  - yg_medicare
+  - yg_multipurpose
+  - yg_music
+  - yg_newage
+  - yg_news
+  - yg_orange
+  - yg_photography
+  - yg_pixel
+  - yg_plumbing
+  - yg_profile
+  - yg_property_one
+  - yg_relic
+  - yg_restaurant
+  - yg_restaurant_lite
+  - yg_simple
+  - yg_solid
+  - yg_sports
+  - yg_sprint
+  - yg_verb
+  - zen
+  - zippy
+  - zircon
+  - ztheme
+  - zurb_clean_blog
+  - zurb_foundation
+  - zurb_template
+admin_themes:
+  - adminimal_theme
+  - material_admin
+  - vartheme_admin
+  - vartheme_material_admin
+  - thunder_admin
+  - druadmin_lte_theme
+  - agnian_material_admin
+  - claro
+  - material_base
+  - eleven
+  - admintheme
+  - uikit_admin
+  - true_admin
+  - smart_admin_theme
+  - smarty_admin
+  - bootstrap_admin
+  - bt_admin_theme
+  - simple_admin
+  - hostinstantlyadmintheme
+  - endless_admin
+  - fortytwo_admin
+  - om_admin
+  - seaside_admin
+
+# What this folder's items ARE, which decides what the dashboard offers on each row:
+#   sites     — real projects with a DDEV environment: build, start, back up, graph, index
+#   code      — repositories checked out to work on, without a site of their own
+#   files     — markdown documents, edited in place
+#   ai-items  — agents, skills and prompts, installable into ~/.claude
+#   media     — recordings and images
+type: code
+
+# What the COMPOSER menu may do here: full | manifest.
+composer: manifest
+
+assistant:
+  name: default
+  placeholder: default

package/dist/src/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The Drupal themes workspace for Webship Workspace: the `themes/` 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 = "themes";
+export declare function register(api: PluginApi): void;

package/dist/src/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * The Drupal themes workspace for Webship Workspace: the `themes/` 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 = 'themes';
+function register(api) {
+    api.addAssistantContext(() => `The themes/ workspace is the Drupal themes workspace (a plugin, @webship.co/workspace-drupal-themes); 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,QAAQ,CAAC;AAEtC,SAAgB,QAAQ,CAAC,GAAc;IACrC,GAAG,CAAC,mBAAmB,CAAC,GAAG,EAAE,CAAC,6JAA6J,CAAC,CAAC;AAC/L,CAAC"}

package/docs/AGENTS.md

@@ -0,0 +1,43 @@
+# Themes
+
+Contrib and private themes, checked out to work on.
+
+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-all-back-end-build-themes.sh
+bash cmd-all-back-end-install-themes.sh
+bash cmd-all-front-end-build-themes.sh
+bash cmd-all-front-end-install-themes.sh
+bash cmd-backup-theme.sh                              # Bootstrap.
+bash cmd-build-admin-theme.sh                         # Bootstrap.
+bash cmd-build-drupal-template.sh
+bash cmd-build-theme.sh                               # Bootstrap.
+bash cmd-install-admin-theme.sh                       # Bootstrap.
+bash cmd-install-theme.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-update-all.sh                          # Find the workspace tooling from this script, so a fresh clone needs no setup.
+```
+
+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 @@
+# Themes — workspace context
+
+You are inside the **themes** 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,47 @@
+# Themes
+--
+
+To Build all front-end themes:
+```
+bash cmd-vdo-all-front-end-build-themes.sh
+```
+
+
+To Install all front-end themes:
+```
+bash cmd-vdo-all-front-end-install-themes.sh
+```
+
+
+To Build all back-end themes:
+```
+bash cmd-vdo-all-back-end-build-themes.sh
+```
+
+
+To Install all back-end themes:
+```
+bash cmd-vdo-all-back-end-install-themes.sh
+```
+
+
+To build one theme:
+You will need to have the template_drupal site.
+if you do not have it you could run the following command
+
+```
+bash cmd-vdo-build-drupal-template.sh
+```
+and then you could build the theme using the templage_drupal site copy 
+with the same name of the theme and install the theme init.
+
+```
+bash cmd-vdo-build-theme.sh THEME_NAME
+```
+Where THEME_NAME is the name of the theme in Drupal.org
+
+To Install a theme site:
+```
+bash cmd-vdo-install-theme.sh THEME_NAME
+```
+

package/features/drupal-themes.feature

@@ -0,0 +1,13 @@
+Feature: The Drupal themes workspace plugin
+  Once the plugin is activated and installed, the themes 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 "/themes"
+     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 "Drupal themes"
+      And I should see "@webship.co/workspace-drupal-themes"

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@webship.co/workspace-drupal-themes",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-beta1",
+  "description": "The Drupal themes workspace for Webship Workspace: the `themes/` folder (type code), its settings file, its 15 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-drupal-themes.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": "drupal-themes",
+    "label": "Drupal themes",
+    "workspace": {
+      "key": "themes",
+      "settingsTemplate": "config/workspace.themes.settings.yml",
+      "files": [
+        "commands/cmd-all-back-end-build-themes.sh",
+        "commands/cmd-all-back-end-install-themes.sh",
+        "commands/cmd-all-front-end-build-themes.sh",
+        "commands/cmd-all-front-end-install-themes.sh",
+        "commands/cmd-backup-theme.sh",
+        "commands/cmd-build-admin-theme.sh",
+        "commands/cmd-build-drupal-template.sh",
+        "commands/cmd-build-theme.sh",
+        "commands/cmd-install-admin-theme.sh",
+        "commands/cmd-install-theme.sh",
+        "commands/cmd-tools-checks.sh",
+        "commands/cmd-tools-gitlab-ci-local.sh",
+        "commands/cmd-tools-reclaim.sh",
+        "commands/cmd-tools-remove.sh",
+        "commands/cmd-tools-update-all.sh"
+      ],
+      "docs": [
+        "docs/AGENTS.md",
+        "docs/CLAUDE.md",
+        "docs/README.md"
+      ]
+    },
+    "features": [
+      "features/drupal-themes.feature"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@webship.co/workspace-plugin-api": "^1.0.0-beta1",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}