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

package/README.md

@@ -1,3 +1,42 @@
-# 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-graphify.sh` |
+| `cmd-tools-obsidian.sh` |
+| `cmd-tools-ragify.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-graphify.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# Map a project in this workspace into a queryable knowledge graph with
+# graphify (https://github.com/Graphify-Labs/graphify), or ask an existing
+# graph a question.
+
+# 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="Build or query the knowledge graph of a project in the themes workspace"
+source ${WORKSPACE_SCRIPTS}/args/arg-graphify.sh || exit 1 ;
+
+shift $#;
+
+if [ ! "${STORE}" == '_none_' ] ; then
+  ensure_graphify || exit 1 ;
+  graphify_store_url "${WORKSPACE_ROOT}/${doc_name}/${PROJECT_NAME}" "${STORE}" ;
+elif [ -n "${QUERY}" ] ; then
+  graphify_query_project ;
+else
+  graphify_project ;
+fi

package/commands/cmd-tools-obsidian.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+# Turn a project's knowledge graph into an Obsidian vault — one note per entity,
+# a [[wikilink]] per relation, and a JSON Canvas of the map. Written next to the
+# graph in graphs/themes/<project>/obsidian/.
+#
+# Build the graph first with cmd-tools-graphify.sh: this reads what that wrote
+# rather than parsing the project a second time.
+
+# 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="Build an Obsidian vault from the knowledge graph of a project in the themes workspace"
+source ${WORKSPACE_SCRIPTS}/args/arg-obsidian.sh || exit 1 ;
+
+shift $#;
+
+export MAX_CANVAS_NODES="${MAX_CANVAS_NODES}";
+
+if [ "${REMOVE}" == 'yes' ] ; then
+  obsidian_remove ;
+elif [ "${STATUS}" == 'yes' ] ; then
+  obsidian_status ;
+else
+  obsidian_project ;
+fi

package/commands/cmd-tools-ragify.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+
+# Index a project in this workspace into the Milvus vector database
+# (https://github.com/milvus-io/milvus) held in ~/workspace/rag, or ask an
+# existing index a question.
+#
+# The RAG counterpart of cmd-tools-graphify.sh: graphify parses the CODE into a
+# graph and reads no Markdown, Twig, *.module hooks or Drupal wiring YAML — this
+# indexes the text of exactly those and retrieves passages from them.
+
+# 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="Build or query the Milvus RAG index of a project in the themes workspace"
+source ${WORKSPACE_SCRIPTS}/args/arg-ragify.sh || exit 1 ;
+
+shift $#;
+
+if [ -n "${QUERY}" ] ; then
+  ragify_query_project ;
+else
+  ragify_project ;
+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