feat: add generation metadata to pyproject.toml (#584)

* feat: add generation metadata to pyproject.toml (R12)

Store generation metadata in [tool.agent-starter-pack] section so CLI
commands can understand project context. This enables:
- enhance command to know original config
- extract command to know what to strip
- upgrade command to re-template old version for diffing
- recommend command to suggest based on current setup
- Any generated project to work as a remote template

Metadata includes:
- Remote template fields: name, description, base_template, agent_directory
- Generation context: generated_at, asp_version, deployment_target,
  session_type, cicd_runner, include_data_ingestion, datastore, frontend_type

Includes end-to-end validation tests that create projects, extract metadata,
recreate using only metadata, and verify identical scaffolding.

* fix: address review feedback for generation metadata

- Improve _compare_scaffolding_files to iterate through all
  SCAFFOLDING_PATTERNS and compare file contents
- Use TOML parsing for pyproject.toml comparison instead of line-by-line
- Simplify data_ingestion Jinja2 template using | lower filter
- Use conditional import pattern for datetime.UTC to support Python 3.10+
  instead of globally ignoring UP017 lint rule

* refactor: always include all metadata fields with 'none' for unset values

Make metadata more consistent and predictable by always including all
fields. Fields that are not applicable use 'none' as the value instead
of being omitted. This simplifies parsing in CLI commands.

Author: eliasecchig

agent_starter_pack/base_template/pyproject.toml

@@ -103,3 +103,21 @@ asyncio_default_fixture_loop_scope = "function"
 
 [tool.hatch.build.targets.wheel]
 packages = ["{{cookiecutter.agent_directory}}","frontend"]
+
+[tool.agent-starter-pack]
+# Generation metadata - enables CLI commands to understand project context
+# These fields allow any generated project to work as a remote template
+name = "{{cookiecutter.project_name}}"
+description = "{{cookiecutter.agent_description}}"
+base_template = "{{cookiecutter.agent_name}}"
+agent_directory = "{{cookiecutter.agent_directory}}"
+
+# Generation context
+generated_at = "{{cookiecutter.generated_at}}"
+asp_version = "{{cookiecutter.package_version}}"
+deployment_target = "{{cookiecutter.deployment_target}}"
+session_type = "{{cookiecutter.session_type or 'none'}}"
+cicd_runner = "{{cookiecutter.cicd_runner}}"
+include_data_ingestion = {{ cookiecutter.data_ingestion | lower }}
+datastore = "{{cookiecutter.datastore_type or 'none'}}"
+frontend_type = "{{cookiecutter.frontend_type}}"

agent_starter_pack/cli/utils/template.py

@@ -22,8 +22,16 @@
 import sys
 import tempfile
 from dataclasses import dataclass
+from datetime import datetime
 from typing import Any
 
+if sys.version_info >= (3, 11):
+    from datetime import UTC
+else:
+    from datetime import timezone
+
+    UTC = timezone.utc  # noqa: UP017 - Required for Python 3.10 compatibility
+
 import yaml
 from cookiecutter.main import cookiecutter
 from rich.console import Console
@@ -1022,6 +1030,7 @@ def get_agent_directory(
                 "project_name": project_name,
                 "agent_name": agent_name,
                 "package_version": get_current_version(),
+                "generated_at": datetime.now(tz=UTC).isoformat(),
                 "agent_description": template_config.get("description", ""),
                 "example_question": template_config.get("example_question", "").ljust(
                     61