@webship.co/workspace 1.0.0-alpha1 → 1.0.0-beta2

package/core/scripts/args/arg-graphs.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('GRAPH_NAME',
+                    nargs='?',
+                    default="_all_",
+                    help='Which graph, as <workspace>/<project> or just <project>. Default: all of them.')
+parser.add_argument('-a', '--graphs-action',
+                    default="list",
+                    choices=['list', 'collect', 'remove', 'mcp-register', 'mcp-unregister', 'serve'],
+                    help='list the graphs, collect strays left inside projects, remove one, register it with the Claude Code CLI over MCP, unregister it, or serve it in the foreground [default %(default)s].')
+ARGEOF

package/core/scripts/args/arg-hostnames.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+# Arguments for a project's extra hostnames. Reporting is the default and the
+# only thing that happens without a flag: this writes DDEV configuration, so
+# nothing changes because somebody asked a question.
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    default='_none_',
+                    nargs='?',
+                    help='The project. Omit to list every project in this workspace and the addresses it answers at.')
+parser.add_argument('-a', '--add',
+                    default="_none_",
+                    help='Add a hostname label (no dots — the project TLD is appended). Example: --add test3-dev')
+parser.add_argument('-w', '--with-workspace',
+                    action='store_true',
+                    help='Add <project>-<workspace>, so the same project name in two workspaces gets two flat addresses (test3-dev.ddev.site, test3-test.ddev.site).')
+parser.add_argument('-r', '--remove',
+                    default="_none_",
+                    help='Remove one of the additional hostnames. The canonical one cannot be removed — it comes from the project name.')
+parser.add_argument('-s', '--start',
+                    action='store_true',
+                    help='Run ddev start afterwards, which is what actually pushes the new route to the router.')
+EOF

package/core/scripts/args/arg-milvus-backup.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='Which Milvus instance to back up. Default: milvus.project from the workspace settings.')
+ARGEOF

package/core/scripts/args/arg-milvus-mcp.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='Which Milvus instance. Default: milvus.project from the workspace settings.')
+parser.add_argument('-a', '--mcp-action',
+                    default="status",
+                    choices=['status', 'register', 'unregister', 'serve'],
+                    help='status shows the instance and whether the CLI knows it; register adds the Milvus MCP server to the Claude Code CLI (stdio, all collections); unregister removes it; serve runs it in the foreground for debugging [default %(default)s].')
+ARGEOF

package/core/scripts/args/arg-milvus.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='Name of the Milvus instance, and so its hostname. Default: milvus.project from the workspace settings.')
+parser.add_argument('-V', '--milvus-version',
+                    default="_settings_",
+                    help='Milvus image tag, e.g. v2.6.21 or v3.0.0 [default: milvus.version from the workspace settings].')
+parser.add_argument('-A', '--attu-version',
+                    default="_settings_",
+                    help='Attu (web UI) image tag [default: milvus.attu_version from the workspace settings].')
+parser.add_argument('-p', '--grpc-port',
+                    default="_settings_",
+                    help='Host port to publish Milvus gRPC/REST on. The first free port from here up is used, because pymilvus and the MCP server cannot go through the DDEV router [default: milvus.grpc_port].')
+parser.add_argument('-u', '--public-uri',
+                    default="_settings_",
+                    help='Which hostname serves the Attu UI: hub (<project>.rag.workspace.ddev.site), canonical (<project>.ddev.site), or a URL used verbatim.')
+parser.add_argument('-a', '--authorization',
+                    action='store_true',
+                    default=False,
+                    help='Turn Milvus authentication on. Off by default: this is a local development database, and every client here would otherwise have to carry the credential.')
+parser.add_argument('-f', '--force',
+                    action='store_true',
+                    default=False,
+                    help='Rebuild an existing instance. This DELETES its volumes — every collection in it goes with them.')
+parser.add_argument('-l', '--launch',
+                    action='store_true',
+                    default=False,
+                    help='Open the Attu UI in a browser when the instance is up.')
+ARGEOF

package/core/scripts/args/arg-obsidian.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The project whose graph becomes a vault.')
+parser.add_argument('-r', '--remove',
+                    action='store_true',
+                    default=False,
+                    help='Delete the vault. The graph it was made from is left alone.')
+parser.add_argument('-s', '--status',
+                    action='store_true',
+                    default=False,
+                    help='Say what is there without building anything.')
+parser.add_argument('-m', '--max-canvas-nodes',
+                    default="300",
+                    help='How many entities the canvas may draw, most-connected first [default %(default)s]. Every entity gets a note either way; this only bounds the canvas, which stops being readable long before it stops being drawable.')
+EOF

package/core/scripts/args/arg-odoo.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+parser.add_argument('-i', '--install',
+                    action='store_true',
+                    default=False,
+                    help='Create the database with the base module, with the workspace account as the administrator.')
+parser.add_argument('--demo',
+                    action='store_true',
+                    default=False,
+                    help='Load Odoo demo data with --install.')
+parser.add_argument('-l', '--launch',
+                    action='store_true',
+                    default=False,
+                    help='Open the site in a browser when it is ready.')
+ARGEOF

package/core/scripts/args/arg-penpot-backup.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='The Penpot instance to back up. Default: penpot.project from the workspace settings.')
+ARGEOF

package/core/scripts/args/arg-penpot-mcp.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+# One option, not five aliases: argparse-bash emits a shell assignment per DEFINED argument, so
+# several `store_const` flags sharing a dest overwrite each other on the way out and `--start`
+# silently parsed as `status`.
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='The Penpot instance the MCP server serves. Default: penpot.project from the workspace settings.')
+parser.add_argument('-a', '--mcp-action',
+                    default="status",
+                    choices=['start', 'stop', 'status', 'register'],
+                    help='start the server container, stop it, report its state, or register it with the Claude Code CLI [default %(default)s].')
+ARGEOF

package/core/scripts/args/arg-penpot-token.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='The Penpot instance to create the token on. Default: penpot.project from the workspace settings.')
+parser.add_argument('-t', '--token-name',
+                    default="drupal ai_penpot",
+                    help='Name the token carries in Penpot [default %(default)s].')
+parser.add_argument('-m', '--email',
+                    default="_settings_",
+                    help='Account to create the token for. Default: penpot.account.email, then account.mail.')
+parser.add_argument('-p', '--password',
+                    default="_settings_",
+                    help='Password for that account. Default: penpot.account.password, then account.pass.')
+ARGEOF

package/core/scripts/args/arg-penpot.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    nargs='?',
+                    default="_settings_",
+                    help='The name of the project. It becomes https://<PROJECT_NAME>.ddev.site. Default: penpot.project from the workspace settings.')
+parser.add_argument('-v', '--penpot-version',
+                    default="_settings_",
+                    help='Penpot image tag for every service. Default: penpot.version from the workspace settings.')
+parser.add_argument('-u', '--public-uri',
+                    default="_settings_",
+                    help='PENPOT_PUBLIC_URI: hub, canonical, or a full URL. The one origin the instance works on. Default: penpot.public_uri from the workspace settings.')
+parser.add_argument('-f', '--flags',
+                    default="_settings_",
+                    help='PENPOT_FLAGS, set on both the frontend and the backend. Default: penpot.flags from the workspace settings (registration, plugins and access tokens on).')
+parser.add_argument('-k', '--secret-key',
+                    default="_settings_",
+                    help='PENPOT_SECRET_KEY. Default: penpot.secret_key, or a per-project key derived from the project name — never a shared literal.')
+parser.add_argument('-M', '--mail-port',
+                    default="_settings_",
+                    help='Host port for this instance mail catcher. Default: penpot.mail_port, and the next free pair upwards when it is taken.')
+parser.add_argument('-n', '--fullname',
+                    default="_settings_",
+                    help='Full name of the first account. Default: penpot.account.fullname, then the account: block in settings.yml.')
+parser.add_argument('-m', '--email',
+                    default="_settings_",
+                    help='Email of the first account. Default: penpot.account.email, then account.mail.')
+parser.add_argument('-p', '--password',
+                    default="_settings_",
+                    help='Password of the first account. Default: penpot.account.password, then account.pass.')
+parser.add_argument('-R', '--no-register',
+                    action='store_true',
+                    default=False,
+                    help='Do not register the first account — register it in the browser instead.')
+parser.add_argument('-l', '--launch',
+                    action='store_true',
+                    default=False,
+                    help='Open the instance in a browser when it is ready.')
+parser.add_argument('-F', '--force',
+                    action='store_true',
+                    default=False,
+                    help='Recreate an existing project: delete the DDEV project (and its Penpot volumes, so the designs go too) and build it again.')
+ARGEOF

package/core/scripts/args/arg-rag.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('RAG_NAME',
+                    nargs='?',
+                    default="_all_",
+                    help='Which index, as <workspace>/<project>, just <project>, or the raw collection name. Default: all of them.')
+parser.add_argument('-a', '--rag-action',
+                    default="list",
+                    choices=['list', 'info', 'search', 'remove', 'servers', 'bind', 'mcp-register', 'mcp-unregister', 'serve', 'status'],
+                    help='list the indexes, describe one, search one, drop one, list the RAG servers, bind a project to one, register the database with the Claude Code CLI over MCP, unregister it, serve it in the foreground, or show its status [default %(default)s].')
+parser.add_argument('-q', '--query',
+                    default="",
+                    help='The question, for -a search. Example: -q "how is the hero section styled"')
+parser.add_argument('-n', '--limit',
+                    default="5",
+                    help='How many passages to return [default %(default)s].')
+parser.add_argument('-m', '--milvus-project',
+                    default="_settings_",
+                    help='Which RAG server (Milvus instance) to use, and what -a bind writes. Pass "default" to unbind [default: the project\'s binding in rag/bindings.yml, else milvus.project from the workspace settings].')
+ARGEOF

package/core/scripts/args/arg-ragify.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project to index.')
+parser.add_argument('-q', '--query',
+                    default="",
+                    help='Ask the existing index a question instead of rebuilding it. Example: --query "where is the newsletter form defined"')
+parser.add_argument('-n', '--limit',
+                    default="5",
+                    help='How many passages a --query returns [default %(default)s].')
+parser.add_argument('-m', '--milvus-instance',
+                    default="_settings_",
+                    help='Which RAG server (Milvus instance in ~/workspace/rag) holds this project\'s index, remembered in rag/bindings.yml for every later run. Pass "default" to unbind. Build another server with rag/cmd-milvus-project.sh <name> [default: the project\'s binding, else the shared default].')
+parser.add_argument('-e', '--embedding',
+                    default="_settings_",
+                    choices=['bm25', 'openai', '_settings_'],
+                    help='bm25 builds the sparse vectors inside Milvus — no model, no key, nothing leaves this machine. openai additionally sends every chunk to the OpenAI API for a dense vector and searches both [default: rag.embedding from the rag workspace settings].')
+parser.add_argument('-S', '--scope',
+                    default="contrib",
+                    choices=['custom', 'contrib', 'all'],
+                    help='How much of the tree to index: custom code only, custom + contrib modules/themes/profiles, or everything including core and vendor [default %(default)s].')
+parser.add_argument('-a', '--all',
+                    action='store_true',
+                    default=False,
+                    help='Same as --scope all: do not skip vendor/, core/, contrib or libraries. Slow, and the index ends up dominated by third-party text.')
+parser.add_argument('-A', '--append',
+                    action='store_true',
+                    default=False,
+                    help='Add to the existing collection instead of rebuilding it. Without this a re-index replaces the collection, which is what keeps a deleted file from staying findable.')
+parser.add_argument('-x', '--exclude',
+                    default="_none_",
+                    nargs='+',
+                    help='Extra paths to skip, on top of the defaults. Example: --exclude "web/modules/custom/legacy tests"')
+ARGEOF

package/core/scripts/args/arg-reclaim.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('-a', '--apply',
+                    action='store_true',
+                    default=False,
+                    help='Actually remove things. WITHOUT this flag the command only reports what it would remove, which is the default on purpose: everything here is a deletion.')
+parser.add_argument('-o', '--only',
+                    default="_none_",
+                    help='Reclaim only these categories, comma separated: cache, volumes, images, containers. Default is all four. Example: --only cache,containers')
+parser.add_argument('-k', '--keep-days',
+                    default="7",
+                    help='Never touch anything created or last used within this many days, whatever else the rules say [default %(default)s]. A project you removed an hour ago may still be one you want back.')
+parser.add_argument('-l', '--list-protected',
+                    action='store_true',
+                    default=False,
+                    help='Print every project name the sweep is protecting and why, then stop. Use this when a removal looks wrong: if a name is on that list, nothing belonging to it can be touched.')
+ARGEOF

package/core/scripts/args/arg-release.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('-t', '--tag',
+                    default='',
+                    help='The tag to cut. Default: the newest one with its last segment bumped.')
+parser.add_argument('-b', '--branch',
+                    default='1.0.x',
+                    help='The branch to release from.')
+parser.add_argument('-n', '--notes',
+                    default='',
+                    help='A file holding the release notes. Without one the notes are generated and have to be written over.')
+parser.add_argument('-g', '--no-gate',
+                    action='store_true',
+                    default=False,
+                    help='Skip the smoke test and the unit tests. For a release that has already been gated elsewhere.')
+parser.add_argument('-c', '--confirm',
+                    action='store_true',
+                    default=False,
+                    help='Actually cut it. Without this the plan is printed and nothing is created.')
+ARGEOF

package/core/scripts/args/arg-screen.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+
+# Arguments for running and managing detached screen sessions.
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('SESSION',
+                    nargs='?',
+                    default="_none_",
+                    help='The screen session name (lowercase, digits, - _ .). Omit with --list.')
+parser.add_argument('-r', '--run',
+                    default="_none_",
+                    help='Start the session detached, running this command; output goes to <workspace>/.screens/<session>.log. Example: --run "bash cmd-webship11-0-x-project.sh demo1 --install"')
+parser.add_argument('-l', '--list',
+                    action='store_true',
+                    default=False,
+                    help='List the live sessions and whether each has a log.')
+parser.add_argument('-o', '--log',
+                    action='store_true',
+                    default=False,
+                    help='Print the session log (works after it finished too).')
+parser.add_argument('-f', '--follow',
+                    action='store_true',
+                    default=False,
+                    help='Follow the session log live until the session ends.')
+parser.add_argument('-s', '--stop',
+                    action='store_true',
+                    default=False,
+                    help='Stop the session (whatever runs inside it is killed).')
+ARGEOF

package/core/scripts/args/arg-site-template.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+# A site-template build takes a name and nothing else.
+#
+# The template decides what the site is — that is the whole point of one — so there is
+# nothing left to choose: no profile, no extra packages, no modules to enable. The
+# version is the latest release, the PHP version is the one DDEV picks, and the build
+# runs the full three steps: the Drupal CMS codebase, the template, the install.
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project. It becomes https://<PROJECT_NAME>.ddev.site')
+EOF

package/core/scripts/args/arg-spdd.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('SPEC_NAME',
+                    nargs='?',
+                    default="_all_",
+                    help='A spec (its number, its slug, or <workspace>/<project>/NNN-slug) — or, when starting one, the TARGET as <workspace>/<project>.')
+parser.add_argument('TOPIC',
+                    nargs='?',
+                    default="_none_",
+                    help='What the change is, in a sentence. Given together with a target, this starts a new spec.')
+parser.add_argument('-a', '--spdd-action',
+                    default="_auto_",
+                    choices=['_auto_', 'list', 'constitution', 'story', 'analysis', 'canvas', 'review', 'read', 'drift', 'sync', 'show'],
+                    help='list the specs, write a product constitution, start one (story), draft the analysis, draft the REASONS Canvas, review a spec against the checklist, read one as a single document, check whether the canvas still matches the tree (drift), record that it does again (sync), or show a spec\'s files. Default: list, or story when a target and a topic are given.')
+ARGEOF

package/core/scripts/args/arg-specs.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('-l', '--list-remote',
+                    action='store_true',
+                    default=False,
+                    help='List the specs the shared repository carries.')
+parser.add_argument('-d', '--diff',
+                    default='_none_',
+                    nargs='?',
+                    const='_all_',
+                    help='Show what the shared copy would change, before taking it. A name filters.')
+parser.add_argument('-p', '--pull',
+                    default='_none_',
+                    nargs='?',
+                    const='_all_',
+                    help='Take the shared copy. Yours is backed up first when it differs. A name filters.')
+parser.add_argument('-s', '--share',
+                    action='store_true',
+                    default=False,
+                    help='How to propose one of yours back to the shared repository. Creates nothing.')
+ARGEOF

package/core/scripts/args/arg-storage.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('-s', '--status',
+                    action='store_true',
+                    default=False,
+                    help='Each workspace: local or on second storage, link health, drive mounted, free space. The default.')
+parser.add_argument('-m', '--move',
+                    default='',
+                    metavar='WORKSPACE',
+                    help='Copy a workspace to second storage, verify by checksum, swap it for a symlink. Keeps <name>.pre-move.')
+parser.add_argument('-b', '--back',
+                    default='',
+                    metavar='WORKSPACE',
+                    help='Bring a workspace back to a local folder, verified. Keeps the copy on the drive.')
+parser.add_argument('-r', '--remove-pre-move',
+                    default='',
+                    metavar='WORKSPACE',
+                    help='Delete <name>.pre-move, only once <name> is a working link to second storage.')
+parser.add_argument('-l', '--relink',
+                    action='store_true',
+                    default=False,
+                    help='Point workspace links at storage.second where the same folder is there (after the drive moved).')
+parser.add_argument('-M', '--mounts',
+                    action='store_true',
+                    default=False,
+                    help='Write the dashboard compose override that mounts the second storage (machine-only, generated).')
+parser.add_argument('-n', '--dry-run',
+                    action='store_true',
+                    default=False,
+                    help='Say what would happen and change nothing.')
+parser.add_argument('-q', '--quiet',
+                    action='store_true',
+                    default=False,
+                    help='Only speak when something changed or is wrong.')
+ARGEOF

package/core/scripts/args/arg-testing.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<ARGEOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The project to set up testing on, or to test.')
+parser.add_argument('-r', '--run',
+                    action='store_true',
+                    default=False,
+                    help='Run the suite instead of setting it up. Without this the command configures the testing environment (idempotent — it adds what is missing and preserves what is there).')
+parser.add_argument('-c', '--configure',
+                    action='store_true',
+                    default=False,
+                    help='Set up (or re-apply) the testing environment. This is what the command does by default; the flag is here so a run reads as one.')
+parser.add_argument('-b', '--browser',
+                    default="chromium",
+                    choices=['chromium', 'firefox', 'webkit'],
+                    help='Which browser the package script runs [default %(default)s].')
+parser.add_argument('-p', '--path',
+                    dest='TESTING_PATH',
+                    default="_none_",
+                    help='Run one feature file or directory instead of the whole suite. Example: --path tests/features/check-homepage.feature')
+parser.add_argument('-H', '--headed',
+                    action='store_true',
+                    default=False,
+                    help='Run with a visible browser (HEADLESS=false), for watching a scenario fail.')
+parser.add_argument('-d', '--dry-run',
+                    action='store_true',
+                    default=False,
+                    help='Compile the suite and match every step against the definitions without opening a browser. Seconds instead of the ~20 minutes a full suite takes, and it is what catches an undefined step or a broken tag expression.')
+parser.add_argument('-R', '--retry',
+                    default="_none_",
+                    help='Retry a failing scenario N times. The projects here already set retry: 1 in cucumber.js; this overrides it for one run.')
+parser.add_argument('-t', '--tags',
+                    default="_none_",
+                    help='Run only the scenarios carrying a Cucumber tag expression. Example: --tags "@critical and not @wip"')
+ARGEOF

package/core/scripts/args/arg-webship.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+parser.add_argument('-i', '--install',
+                    action='store_true',
+                    default=False,
+                    help='Add the install flag to install the project.')
+parser.add_argument('-a', '--add-users',
+                    action='store_true',
+                    default=False,
+                    help='Add default set of users to the project in the case of install')
+parser.add_argument('-r', '--require',
+                    default="_none_",
+                    nargs='+',
+                    help='Require more modules/themes/libraries by composer. Example: --require "drupal/ctools:~3.0 drupal/token:~1.0"')
+parser.add_argument('-e', '--enable',
+                    default="_none_",
+                    nargs='+',
+                    help='Enable modules right after the install. Example: --enable "media media_library ctools token"')
+parser.add_argument('-s', '--skip-set-default-settings',
+                    action='store_true',
+                    default=False,
+                    help='Skip set default settings file before starting the install')
+parser.add_argument('-d', '--skip-drop-database',
+                    action='store_true',
+                    default=False,
+                    help='Skip drop the database and create it again before starting the install')
+parser.add_argument('-p', '--php-version',
+                    default="",
+                    choices=['8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '7.4'],
+                    help='PHP version for the project container. The seven most recent PHP releases DDEV supports; empty means the builder default. Example: --php-version 8.3')
+EOF

package/core/scripts/args/arg-webships-project.sh

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+# A Webships Project build takes a name and which API site template to install.
+#
+# The installer lists the templates and applies the chosen one, so there is
+# nothing else to decide: no profile, no extra packages, no modules to enable.
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project. It becomes https://<PROJECT_NAME>.ddev.site')
+parser.add_argument('-t', '--template',
+                    default='webships_starter',
+                    help='The API site template to install: webships_starter or webapi_starter. default [ webships_starter ]')
+parser.add_argument('-a', '--add-users',
+                    action='store_true',
+                    default=False,
+                    help='Add the default set of users to the installed site.')
+parser.add_argument('-p', '--php-version',
+                    default="",
+                    choices=['8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '7.4'],
+                    help='PHP version for the project container. The seven most recent PHP releases DDEV supports; empty means the builder default. Example: --php-version 8.3')
+EOF

package/core/scripts/args/arg-webships-site-template.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+# An API site-template build takes a name, and whether to add the default users.
+#
+# The template decides what the site is — that is the whole point of one — so there is
+# nothing left to choose: no profile, no extra packages, no modules to enable. The
+# version is set by the calling builder, and the PHP version is pinned to the one the
+# API line is tested on.
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project. It becomes https://<PROJECT_NAME>.ddev.site')
+parser.add_argument('-a', '--add-users',
+                    action='store_true',
+                    default=False,
+                    help='Add the default set of users to the installed site.')
+EOF

package/core/scripts/args/arg-webships.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project.')
+parser.add_argument('-i', '--install',
+                    action='store_true',
+                    default=False,
+                    help='Add the install flag to install the project.')
+parser.add_argument('-a', '--add-users',
+                    action='store_true',
+                    default=False,
+                    help='Add default set of users to the project in the case of install')
+parser.add_argument('-r', '--require',
+                    default="_none_",
+                    nargs='+',
+                    help='Require more modules/themes/libraries by composer. Example: --require "drupal/ctools:~3.0 drupal/token:~1.0"')
+parser.add_argument('-e', '--enable',
+                    default="_none_",
+                    nargs='+',
+                    help='Enable modules right after the install. Example: --enable "media media_library ctools token"')
+parser.add_argument('-s', '--skip-set-default-settings',
+                    action='store_true',
+                    default=False,
+                    help='Skip set default settings file before starting the install')
+parser.add_argument('-d', '--skip-drop-database',
+                    action='store_true',
+                    default=False,
+                    help='Skip drop the database and create it again before starting the install')
+parser.add_argument('-p', '--php-version',
+                    default="",
+                    choices=['8.5', '8.4', '8.3', '8.2', '8.1', '8.0', '7.4'],
+                    help='PHP version for the project container. The seven most recent PHP releases DDEV supports; empty means the builder default. Example: --php-version 8.3')
+EOF

package/core/scripts/args/arg-website-site-template.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+# A Website/Webship site-template recipe applied on a plain Drupal 11.4.x
+# recommended project. The recipe decides what the site is.
+
+argparse "$@" <<EOF || exit 1
+parser.add_argument('PROJECT_NAME',
+                    help='The name of the project. It becomes https://<PROJECT_NAME>.ddev.site')
+parser.add_argument('-a', '--add-users',
+                    action='store_true',
+                    default=False,
+                    help='Add the default set of users after the install.')
+parser.add_argument('-f', '--with-pending-fixes',
+                    action='store_true',
+                    default=False,
+                    help='Pin the web* issue-fork branches that are not merged yet (webblog MR !4, webreleases MR !5).')
+EOF