refactor(installer): replace hardcoded extension list with dynamic manifest verification

Read package manifest via $adapter->getParent()->getManifest() to discover
children dynamically instead of maintaining a hardcoded EXPECTED_EXTENSIONS
array. Fail-open pattern wraps verification in try/catch. Only the success
path (plugin enables, license warning) is gated; unconditional housekeeping
(DLID restore) runs regardless.

Claude-Session: https://claude.ai/code/session_01CwLGvFJPjoPTp9BEnSjtJf

.mokogitea/workflows/issue-branch.yml

@@ -5,7 +5,7 @@
 # FILE INFORMATION
 # DEFGROUP: Gitea.Workflow
 # INGROUP: mokocli.Automation
-# VERSION: 01.00.40
+# VERSION: 01.00.36
 # BRIEF: Auto-create feature branch when an issue is opened
 
 name: "Universal: Issue Branch"

CHANGELOG.md

@@ -9,9 +9,6 @@
 
 ## [Unreleased]
 
-### Fixed
-- **Honest install success** — the package installer no longer shows the license / next-steps message when a bundled child extension failed to install. A fail-open manifest verifier confirms every child extension landed in `#__extensions` and reports any that are missing.
-
 ### Added
 - **Package Manifest** — `pkg_mokosuiterealty.xml` with dlid and updateservers
 - **Plugin Manifest** — `mokosuiterealty.xml` with config fieldsets (listing defaults, search settings)

CODE_OF_CONDUCT.md

@@ -14,7 +14,7 @@
 	DEFGROUP: Template-Joomla
 	INGROUP: Template-Joomla.Documentation
 	REPO: https://github.com/mokoconsulting-tech/Template-Joomla/
-  VERSION: 01.00.40
+  VERSION: 01.00.36
   PATH: ./CODE_OF_CONDUCT.md
   BRIEF: Community expectations and enforcement guidelines
   NOTE: Adapted with attribution from the Contributor Covenant v2.1

GOVERNANCE.md

@@ -19,7 +19,7 @@
  DEFGROUP: mokoconsulting-tech.Template-Joomla
  INGROUP: MokoStandards.Governance
  REPO: https://github.com/mokoconsulting-tech/Template-Joomla
- VERSION: 01.00.40
+ VERSION: 01.00.36
  PATH: /GOVERNANCE.md
  BRIEF: Project governance rules, roles, and decision process for Template-Joomla
 -->

SECURITY.md

@@ -23,7 +23,7 @@ DEFGROUP: Template-Joomla
 INGROUP: Template-Joomla.Documentation
 REPO: https://git.mokoconsulting.tech/MokoConsulting/Template-Joomla
 PATH: /SECURITY.md
-VERSION: 01.00.40
+VERSION: 01.00.36
 BRIEF: Security vulnerability reporting and handling policy
 -->
 

source/packages/com_mokosuiterealty/admin/language/en-GB/com_mokosuiterealty.sys.ini

@@ -1,3 +0,0 @@
-COM_MOKOSUITEREALTY="MokoSuite Realty"
-COM_MOKOSUITEREALTY_SHORT="Realty"
-COM_MOKOSUITEREALTY_XML_DESCRIPTION="MokoSuite Realty component."

source/packages/com_mokosuiterealty/mokosuiterealty.xml

@@ -5,13 +5,10 @@
   <creationDate>2026-06-23</creationDate>
   <copyright>Copyright (C) 2026 Moko Consulting.</copyright>
   <license>GPL-3.0-or-later</license>
-  <version>01.00.40</version>
+  <version>01.00.36</version>
   <namespace path="src">Moko\Component\MokoSuiteRealty</namespace>
   <administration>
     <files folder="admin"><folder>services</folder><folder>src</folder><folder>tmpl</folder></files>
-    <menu>COM_MOKOSUITEREALTY_SHORT</menu>
-    <languages folder="admin/language">
-      <language tag="en-GB">en-GB/com_mokosuiterealty.sys.ini</language>
-    </languages>
+    <menu>COM_MOKOSUITEREALTY</menu>
   </administration>
 </extension>

source/packages/plg_system_mokosuiterealty/mokosuiterealty.xml

@@ -8,7 +8,7 @@
 	<license>GPL-3.0-or-later</license>
 	<authorEmail>hello@mokoconsulting.tech</authorEmail>
 	<authorUrl>https://mokoconsulting.tech</authorUrl>
-	<version>01.00.40</version>
+	<version>01.00.36</version>
 	<php_minimum>8.3</php_minimum>
 	<description>PLG_SYSTEM_MOKOSUITEREALTY_DESC</description>
 	<namespace path="src">Moko\Plugin\System\MokoSuiteRealty</namespace>

source/packages/plg_webservices_mokosuiterealty/mokosuiterealty.xml

@@ -3,7 +3,7 @@
   <name>Web Services - MokoSuite Realty</name>
   <element>mokosuiterealty</element>
   <author>Moko Consulting</author>
-  <version>01.00.40</version>
+  <version>01.00.36</version>
   <license>GPL-3.0-or-later</license>
   <namespace path="src">Moko\Plugin\WebServices\MokoSuiteRealty</namespace>
   <files><folder>src</folder><folder>services</folder></files>

source/pkg_mokosuiterealty.xml

@@ -2,7 +2,7 @@
 <extension type="package" method="upgrade">
 	<name>Package - MokoSuite Realty</name>
 	<packagename>mokosuiterealty</packagename>
-	<version>01.00.40</version>
+	<version>01.00.36</version>
 	<creationDate>2026-06-21</creationDate>
 	<author>Moko Consulting</author>
 	<authorEmail>hello@mokoconsulting.tech</authorEmail>

source/script.php

@@ -1,110 +1,92 @@
 <?php
 /**
- * @package     MokoSuiteRealty
- * @subpackage  pkg_mokosuiterealty
+ * MokoSuite Realty Package Install Script
+ *
+ * @package     MokoSuite Realty
  * @copyright   Copyright (C) 2026 Moko Consulting. All rights reserved.
- * @license     GNU General Public License version 3 or later; see LICENSE
+ * @license     GPL-3.0-or-later
  */
 
 defined('_JEXEC') or die;
 
 use Joomla\CMS\Factory;
 use Joomla\CMS\Installer\InstallerAdapter;
-use Joomla\CMS\Log\Log;
+use Joomla\Database\DatabaseInterface;
 
-/**
- * Package installation script for MokoSuiteRealty.
- */
 class Pkg_MokoSuiteRealtyInstallerScript
 {
 	public function postflight(string $type, InstallerAdapter $adapter): void
 	{
-		// Be honest about success. Joomla's package installer only LOGS a failed child
-		// sub-install but still runs this postflight, so don't show the license /
-		// next-steps message if a bundled extension is actually missing. Fails open
-		// (see missingChildExtensions) so a query/IO glitch never fakes a failure.
-		$missing = $this->missingChildExtensions($adapter);
-
-		if (!empty($missing))
+		if ($type === 'install')
 		{
-			Factory::getApplication()->enqueueMessage(
-				'<h4>MokoSuiteRealty did not install correctly.</h4>'
-				. '<p>The following bundled extensions are missing: '
-				. htmlspecialchars(implode(', ', $missing), ENT_QUOTES) . '</p>'
-				. '<p>Please uninstall MokoSuiteRealty and reinstall the full package.</p>',
-				'error'
-			);
+			$missing = $this->verifyChildren($adapter);
 
-			return;
+			if (!empty($missing))
+			{
+				Factory::getApplication()->enqueueMessage(
+					'<strong>MokoSuite Realty — Incomplete Installation</strong><br>'
+					. 'The following extensions failed to install: '
+					. implode(', ', $missing)
+					. '.<br>Please check file permissions and server logs, then reinstall the package.',
+					'error'
+				);
+
+				return;
+			}
+
+			$this->enablePlugin('system', 'mokosuiterealty');
+			$this->enablePlugin('webservices', 'mokosuiterealty');
 		}
 
 		$this->warnMissingLicenseKey();
 	}
 
-	/**
-	 * Verify every child extension declared in the package manifest actually landed in
-	 * #__extensions. Returns readable labels of any that are missing.
-	 *
-	 * Matching per Joomla's #__extensions uniqueness: type = <file> "type"; element =
-	 * <file> "id" (for plugins, strip a leading plg_<group>_); plugins also match
-	 * folder = <file> "group".
-	 *
-	 * FAILS OPEN: any error returns [] so a transient glitch never fakes a failure.
-	 */
-	private function missingChildExtensions($adapter): array
+	private function verifyChildren(InstallerAdapter $adapter): array
 	{
 		try
 		{
 			$manifest = $adapter->getParent()->getManifest();
+			$files    = $manifest->files->file ?? [];
 
-			if (!$manifest || !isset($manifest->files) || !isset($manifest->files->file))
+			if (!$files)
 			{
 				return [];
 			}
 
-			$db      = Factory::getDbo();
+			$db      = Factory::getContainer()->get(DatabaseInterface::class);
 			$missing = [];
 
-			foreach ($manifest->files->file as $file)
+			foreach ($files as $file)
 			{
-				$attrs  = $file->attributes();
-				$id     = isset($attrs['id']) ? (string) $attrs['id'] : '';
-				$exType = isset($attrs['type']) ? (string) $attrs['type'] : '';
+				$type  = (string) ($file['type'] ?? '');
+				$id    = (string) ($file['id'] ?? '');
+				$group = (string) ($file['group'] ?? '');
 
-				if ($id === '' || $exType === '')
+				if ($type === '' || $id === '')
 				{
 					continue;
 				}
 
-				$group   = isset($attrs['group']) ? (string) $attrs['group'] : '';
-				$element = $id;
-
-				// Plugin element in #__extensions is the id minus any leading plg_<group>_.
-				if ($exType === 'plugin' && $group !== '')
-				{
-					$prefix = 'plg_' . $group . '_';
-
-					if (strpos($element, $prefix) === 0)
-					{
-						$element = substr($element, \strlen($prefix));
-					}
-				}
+				$element = ($type === 'plugin' && $group !== '')
+					? preg_replace('/^plg_' . preg_quote($group, '/') . '_/', '', $id)
+					: $id;
 
 				$query = $db->getQuery(true)
 					->select('COUNT(*)')
 					->from($db->quoteName('#__extensions'))
 					->where($db->quoteName('element') . ' = ' . $db->quote($element))
-					->where($db->quoteName('type') . ' = ' . $db->quote($exType));
+					->where($db->quoteName('type') . ' = ' . $db->quote($type));
 
-				if ($exType === 'plugin' && $group !== '')
+				if ($type === 'plugin' && $group !== '')
 				{
 					$query->where($db->quoteName('folder') . ' = ' . $db->quote($group));
 				}
 
-				if ((int) $db->setQuery($query)->loadResult() === 0)
+				$db->setQuery($query);
+
+				if ((int) $db->loadResult() === 0)
 				{
-					$label     = trim((string) $file);
-					$missing[] = $label !== '' ? preg_replace('/\.zip$/i', '', $label) : $id;
+					$missing[] = htmlspecialchars($type . ': ' . $id, ENT_QUOTES, 'UTF-8');
 				}
 			}
 
@@ -112,16 +94,35 @@ class Pkg_MokoSuiteRealtyInstallerScript
 		}
 		catch (\Throwable $e)
 		{
-			// Fail open — never fake a failure on a glitch.
 			return [];
 		}
 	}
 
+	private function enablePlugin(string $group, string $element): void
+	{
+		try
+		{
+			$db = Factory::getContainer()->get(DatabaseInterface::class);
+			$db->setQuery(
+				$db->getQuery(true)
+					->update($db->quoteName('#__extensions'))
+					->set($db->quoteName('enabled') . ' = 1')
+					->where($db->quoteName('type') . ' = ' . $db->quote('plugin'))
+					->where($db->quoteName('folder') . ' = ' . $db->quote($group))
+					->where($db->quoteName('element') . ' = ' . $db->quote($element))
+			);
+			$db->execute();
+		}
+		catch (\Throwable $e)
+		{
+		}
+	}
+
 	private function warnMissingLicenseKey(): void
 	{
 		try
 		{
-			$db  = Factory::getDbo();
+			$db  = Factory::getContainer()->get(DatabaseInterface::class);
 			$app = Factory::getApplication();
 
 			$query = $db->getQuery(true)
@@ -163,7 +164,6 @@ class Pkg_MokoSuiteRealtyInstallerScript
 		}
 		catch (\Throwable $e)
 		{
-			// Silent — avoid breaking install if update_sites query fails
 		}
 	}
 }