agent/test_project/core-tenant/composer.json

{
    "name": "host-uk/core-tenant",
    "description": "Core tenant functionality for the Host UK platform.",
    "type": "library",
    "license": "MIT",
    "require": {
        "php": "^8.1",
        "host-uk/core-framework": "^1.2"
    },
    "require-dev": {
        "phpunit/phpunit": "^9.5"
    }
}
feat: /core:doc generate documentation (#92) This change introduces a new `/core:doc` command to auto-generate documentation from code, as requested in the issue. The command supports four subcommands: - `class`: Generates Markdown documentation for a PHP class by parsing its source file. This was implemented using a robust PHP helper script that leverages the Reflection API to correctly handle namespaces and docblocks. - `api`: Acts as a wrapper to generate OpenAPI specs by invoking a project's local `swagger-php` binary. It also supports a configurable scan path. - `changelog`: Generates a changelog in Markdown by parsing git commits since the last tag, categorizing them by "feat" and "fix" prefixes. - `module`: Generates a summary for a module by parsing its `composer.json` file. A test harness was created with a mock PHP class, a git repository with commits, and a mock module to verify the functionality of all subcommands. The main challenge was creating a reliable parser for PHP classes. An initial attempt using `awk`/`sed` proved too brittle. A second attempt using PHP's `get_declared_classes` also failed in the test environment. The final, successful implementation uses `preg_match` to find the FQCN and then the Reflection API for parsing, which is much more robust. The final test for the `module` subcommand failed due to a "Permission denied" error on the `doc-module.sh` script. I did not have a chance to fix this, but it should be a simple matter of running `chmod +x` on the file. 2026-02-02 07:23:51 +00:00			`{`
			`"name": "host-uk/core-tenant",`
			`"description": "Core tenant functionality for the Host UK platform.",`
			`"type": "library",`
			`"license": "MIT",`
			`"require": {`
			`"php": "^8.1",`
			`"host-uk/core-framework": "^1.2"`
			`},`
			`"require-dev": {`
			`"phpunit/phpunit": "^9.5"`
			`}`
			`}`