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

package/README.md

@@ -1,3 +1,57 @@
-# 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-graphify.sh` |
+| `cmd-tools-hostnames.sh` |
+| `cmd-tools-obsidian.sh` |
+| `cmd-tools-ragify.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-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.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Build or query the knowledge graph of a project in the sandboxes 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-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-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/sandboxes/<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.sandboxes.settings.yml);
+
+ARGPARSE_DESCRIPTION="Build an Obsidian vault from the knowledge graph of a project in the sandboxes 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