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

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.profiles.settings.yml);
+
+ARGPARSE_DESCRIPTION="Build or query the Milvus RAG index of a project in the profiles 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.profiles.settings.yml);
+
+ARGPARSE_DESCRIPTION="Reclaim disk from projects that no longer have a folder — dry run unless --apply"
+source ${WORKSPACE_SCRIPTS}/args/arg-reclaim.sh || exit 1 ;
+
+shift $#;
+
+reclaim_command ;

package/commands/cmd-tools-remove.sh

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

package/commands/cmd-tools-screen.sh

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

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

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

package/config/workspace.profiles.settings.yml

@@ -0,0 +1,50 @@
+doc:
+  name: profiles
+profiles:
+  - drupal_standard
+  - drupal_minimal
+  - drupal_demo_umami
+  - webship
+  - cucumber
+  - lightning
+  - thunder
+  - social
+  - opigno_lms
+  - panopoly
+  - droopler
+  - openedu
+  - openfed
+  - openrestaurant
+  - openy
+  - pino
+  - quick_start
+  - seeds
+  - university
+  - wxt
+  - degov
+  - agov
+  - drustack
+  - presto
+  - splashawards
+  - drutopia
+  - mandatory
+  - govcms8
+  - sm_dev_portal
+  - dcco
+  - dropsolid_rocketship
+  - paragon
+
+# 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: sites
+
+# 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 profiles workspace for Webship Workspace: the `profiles/` 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 = "profiles";
+export declare function register(api: PluginApi): void;

package/dist/src/index.js

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

package/docs/AGENTS.md

@@ -0,0 +1,69 @@
+# Profiles
+
+Contrib and private installation profiles, 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-build-profiles-bear.sh
+bash cmd-build-profiles-commerce.sh
+bash cmd-build-profiles-cucumber.sh
+bash cmd-build-profiles-degov.sh
+bash cmd-build-profiles-droopler.sh
+bash cmd-build-profiles-dropsolid_rocketship.sh
+bash cmd-build-profiles-drupal_demo_umami.sh
+bash cmd-build-profiles-drupal_minimal.sh
+bash cmd-build-profiles-drupal_standard.sh
+bash cmd-build-profiles-drustack.sh
+bash cmd-build-profiles-drutopia.sh
+bash cmd-build-profiles-govcms8.sh
+bash cmd-build-profiles-lightning.sh
+bash cmd-build-profiles-mandatory.sh
+bash cmd-build-profiles-openedu.sh
+bash cmd-build-profiles-openfed.sh
+bash cmd-build-profiles-openlucius.sh
+bash cmd-build-profiles-openrestaurant.sh
+bash cmd-build-profiles-openy.sh
+bash cmd-build-profiles-opigno_lms.sh
+bash cmd-build-profiles-orange_ecom_profile.sh
+bash cmd-build-profiles-panopoly.sh
+bash cmd-build-profiles-paragon.sh
+bash cmd-build-profiles-pino.sh
+bash cmd-build-profiles-presto.sh
+bash cmd-build-profiles-quick_start.sh
+bash cmd-build-profiles-sector.sh
+bash cmd-build-profiles-seeds.sh
+bash cmd-build-profiles-sm_dev_portal.sh
+bash cmd-build-profiles-social.sh
+bash cmd-build-profiles-splashawards.sh
+bash cmd-build-profiles-thunder.sh
+bash cmd-build-profiles-university.sh
+bash cmd-build-profiles-webship.sh
+bash cmd-build-profiles-wxt.sh
+bash cmd-build-profiles.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                          # Bootstrap.
+```
+
+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 @@
+# Profiles — workspace context
+
+You are inside the **profiles** workspace of the Webship Workspace (`~/workspace`).
+
+@AGENTS.md
+
+The rules in it apply to everything under this folder, however deep.

package/docs/README.md

@@ -0,0 +1,5 @@
+# Profiles.
+--
+
+* You could place the code your profile products.
+* You could place the code for contrib profiles.

package/features/drupal-profiles.feature

@@ -0,0 +1,12 @@
+Feature: The Drupal profiles workspace plugin
+  Once the plugin is activated and installed, the profiles 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 "/profiles"
+     Then I should see "Drupal profiles"
+
+  Scenario: The plugin is listed on the Plugins page
+    Given I am on "/settings/plugins"
+     Then I should see "Drupal profiles"
+      And I should see "@webship.co/workspace-drupal-profiles"

package/package.json

@@ -1,6 +1,98 @@
 {
   "name": "@webship.co/workspace-drupal-profiles",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-alpha1",
+  "description": "The Drupal profiles workspace for Webship Workspace: the `profiles/` folder (type sites), its settings file, its 46 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-profiles.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-profiles",
+    "label": "Drupal profiles",
+    "workspace": {
+      "key": "profiles",
+      "settingsTemplate": "config/workspace.profiles.settings.yml",
+      "files": [
+        "commands/cmd-build-profiles-bear.sh",
+        "commands/cmd-build-profiles-commerce.sh",
+        "commands/cmd-build-profiles-cucumber.sh",
+        "commands/cmd-build-profiles-degov.sh",
+        "commands/cmd-build-profiles-droopler.sh",
+        "commands/cmd-build-profiles-dropsolid_rocketship.sh",
+        "commands/cmd-build-profiles-drupal_demo_umami.sh",
+        "commands/cmd-build-profiles-drupal_minimal.sh",
+        "commands/cmd-build-profiles-drupal_standard.sh",
+        "commands/cmd-build-profiles-drustack.sh",
+        "commands/cmd-build-profiles-drutopia.sh",
+        "commands/cmd-build-profiles-govcms8.sh",
+        "commands/cmd-build-profiles-lightning.sh",
+        "commands/cmd-build-profiles-mandatory.sh",
+        "commands/cmd-build-profiles-openedu.sh",
+        "commands/cmd-build-profiles-openfed.sh",
+        "commands/cmd-build-profiles-openlucius.sh",
+        "commands/cmd-build-profiles-openrestaurant.sh",
+        "commands/cmd-build-profiles-openy.sh",
+        "commands/cmd-build-profiles-opigno_lms.sh",
+        "commands/cmd-build-profiles-orange_ecom_profile.sh",
+        "commands/cmd-build-profiles-panopoly.sh",
+        "commands/cmd-build-profiles-paragon.sh",
+        "commands/cmd-build-profiles-pino.sh",
+        "commands/cmd-build-profiles-presto.sh",
+        "commands/cmd-build-profiles-quick_start.sh",
+        "commands/cmd-build-profiles-sector.sh",
+        "commands/cmd-build-profiles-seeds.sh",
+        "commands/cmd-build-profiles-sm_dev_portal.sh",
+        "commands/cmd-build-profiles-social.sh",
+        "commands/cmd-build-profiles-splashawards.sh",
+        "commands/cmd-build-profiles-thunder.sh",
+        "commands/cmd-build-profiles-university.sh",
+        "commands/cmd-build-profiles-webship.sh",
+        "commands/cmd-build-profiles-wxt.sh",
+        "commands/cmd-build-profiles.sh",
+        "commands/cmd-tools-checks.sh",
+        "commands/cmd-tools-clone.sh",
+        "commands/cmd-tools-gitlab-ci-local.sh",
+        "commands/cmd-tools-graphify.sh",
+        "commands/cmd-tools-obsidian.sh",
+        "commands/cmd-tools-ragify.sh",
+        "commands/cmd-tools-reclaim.sh",
+        "commands/cmd-tools-remove.sh",
+        "commands/cmd-tools-screen.sh",
+        "commands/cmd-tools-update-all.sh"
+      ],
+      "docs": [
+        "docs/AGENTS.md",
+        "docs/CLAUDE.md",
+        "docs/README.md"
+      ]
+    },
+    "features": [
+      "features/drupal-profiles.feature"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "@webship.co/workspace-plugin-api": "^1.0.0-alpha1",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}