test: add complex test-project2 covering all edge cases

Author: Maneesh-Relanto

tests/test-project2/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to Acme Platform are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+---
+
+## [2.1.0] — 2026-01-15
+
+### Added
+- New GraphQL subscription support for real-time events
+- `acme watch` CLI command for live log tailing
+- Prometheus metrics endpoint at `/metrics`
+
+### Fixed
+- Race condition in background job queue under high load
+- Incorrect UTC offset in scheduled tasks running after DST change
+
+### Changed
+- Default timeout increased from 30s to 60s
+- Log format now includes trace ID for distributed tracing
+
+---
+
+## [2.0.0] — 2025-09-01
+
+### Breaking Changes
+- Dropped Python 3.9 support; minimum is now 3.11
+- Renamed `acme.utils.helpers` to `acme.core.utils`
+
+### Added
+- Complete REST API rewrite using FastAPI
+- OpenAPI 3.1 spec auto-generated at `/openapi.json`
+- First-class async support throughout
+
+---
+
+## [1.4.2] — 2025-06-10
+
+### Fixed
+- Memory leak in connection pool under sustained traffic
+- Crash on empty config file

tests/test-project2/CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing
+
+Thank you for your interest in contributing to Acme Platform!
+
+## Development Setup
+
+```bash
+git clone https://github.com/acme/platform.git
+cd platform
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements-dev.txt
+```
+
+## Code Style
+
+- Follow PEP 8 for Python code
+- Run `ruff check .` before committing
+- All public functions must have docstrings
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Commit your changes with clear messages
+4. Open a pull request against `main`
+
+## Reporting Bugs
+
+Open an issue using the bug report template.
+Include repro steps, expected behaviour, and observed behaviour.
+
+## Questions?
+
+Join our Discord server or open a discussion on GitHub.

tests/test-project2/LICENSE.md

@@ -0,0 +1,23 @@
+# License
+
+MIT License
+
+Copyright (c) 2026 Acme Corp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

tests/test-project2/README.md

@@ -0,0 +1,68 @@
+# Acme Platform
+
+A fictional multi-service platform used to exercise every link and discovery
+edge case in MD Files Connector.
+
+---
+
+## Quick Links
+
+- [Contributing Guide](CONTRIBUTING.md)
+- [Changelog](CHANGELOG.md)
+- <a href="LICENSE.md">License</a>
+- [REST API Reference](docs/api/REST.md)
+- [Quickstart Guide](docs/guides/quickstart.md)
+- [Architecture Overview](./docs/internal/ARCHITECTURE.md)
+
+<!-- Duplicate link — should count REST.md only once -->
+- [REST API Reference (mirror)](docs/api/REST.md)
+
+<!-- Dangling link — file does not exist on disk -->
+- [Deprecated API v1](docs/deprecated/OLD_API.md)
+
+---
+
+## Installation
+
+```bash
+pip install acme-platform
+```
+
+---
+
+## Usage
+
+```bash
+acme start --config config.yml
+```
+
+---
+
+## API Examples
+
+```bash
+# Fetch all users
+curl -H "Authorization: Bearer $TOKEN" https://api.acme.example.com/v2/users
+
+# Submit a background job
+curl -X POST -H "Authorization: Bearer $TOKEN" \
+  -d '{"type":"report","params":{"month":"2026-01"}}' \
+  https://api.acme.example.com/v2/jobs
+```
+
+> **GraphQL:** A GraphQL API is available alongside REST. See the internal
+> team wiki for schema details (not yet public-facing documentation).
+
+---
+
+## External Resources
+
+- [Official Python Docs](https://docs.python.org/3/)
+- [PyPI](https://pypi.org/project/acme-platform/)
+- Hosted API spec at https://acme.example.com/openapi.md
+
+---
+
+## License
+
+© 2026 Acme Corp — see <a href="LICENSE.md">LICENSE.md</a> for details.

tests/test-project2/SCRATCH.md

@@ -0,0 +1,2 @@
+
+brainstorming notes — ignore

tests/test-project2/docs/README.md

@@ -0,0 +1,15 @@
+# Docs
+
+Welcome to the Acme Platform documentation hub.
+
+This nested README exists inside the `docs/` folder and is intentionally
+**not linked from the root README**. It represents a common pattern where
+teams add a README inside a docs directory but forget to surface it from
+the root. The MD Files Connector should flag this as isolated.
+
+## Contents
+
+- `api/` — REST and GraphQL API reference
+- `guides/` — User guides and tutorials
+- `internal/` — Internal architecture and decision records
+- `adr/` — Architecture Decision Records

tests/test-project2/docs/adr/0001-initial-setup.md

@@ -0,0 +1,46 @@
+# ADR 0001 — Initial Architecture and Tech Stack
+
+**Date:** 2024-03-01
+**Status:** Accepted
+**Deciders:** Platform Team
+
+---
+
+## Context
+
+We are building a new multi-tenant SaaS platform from scratch. We need to
+choose the core technology stack, API style, data store, and deployment
+approach before writing any product code.
+
+## Decision
+
+We will use the following stack:
+
+- **Language:** Python 3.11+ (familiar to the whole team; strong async support)
+- **API framework:** FastAPI (native async, auto-OpenAPI, Pydantic validation)
+- **Database:** PostgreSQL 16 (battle-tested, rich feature set, full ACID)
+- **Cache / queue:** Redis 7 (used for both ephemeral caching and job queues)
+- **Deployment:** Docker + Kubernetes on AWS EKS
+- **CI/CD:** GitHub Actions with multi-stage Docker builds
+
+## Consequences
+
+### Positive
+- FastAPI's automatic OpenAPI generation eliminates manual spec maintenance
+- PostgreSQL's JSONB support gives flexibility for semi-structured payloads
+- Kubernetes enables zero-downtime deploys and auto-scaling
+
+### Negative
+- Kubernetes operational overhead; requires team upskilling on cluster management
+- Python GIL limits CPU-bound parallelism; addressed by multi-process workers
+
+## Alternatives Considered
+
+- **Node.js / NestJS** — rejected; team is more fluent in Python
+- **MongoDB** — rejected; relational data model is clearer for this domain
+- **Serverless (Lambda)** — rejected; cold-start latency unacceptable for sync API
+
+## Review Date
+
+Revisit this decision when team size exceeds 20 engineers or annual request
+volume exceeds 1 billion.

tests/test-project2/docs/adr/README.md

@@ -0,0 +1,10 @@
+# Architecture Decision Records
+
+Index of all ADRs for Acme Platform.
+
+| # | Title | Status | Date |
+|---|-------|--------|------|
+| [0001](0001-initial-setup.md) | Initial architecture and tech stack | Accepted | 2024-03-01 |
+
+New ADRs should be added to this index and linked from here.
+Use the template in `0001-initial-setup.md` as a starting point.

tests/test-project2/docs/api/GRAPHQL.md

@@ -0,0 +1,83 @@
+# GraphQL API Reference
+
+The Acme Platform GraphQL API provides a flexible query interface for all
+platform resources.
+
+## Endpoint
+
+`POST https://api.acme.example.com/graphql`
+
+Include `Authorization: Bearer <token>` in the request header.
+
+## Schema Overview
+
+### Queries
+
+```graphql
+# Fetch a user by ID
+query GetUser($id: ID!) {
+  user(id: $id) {
+    id
+    email
+    name
+    createdAt
+    organizations {
+      id
+      name
+    }
+  }
+}
+
+# List jobs with status filter
+query ListJobs($status: JobStatus) {
+  jobs(status: $status) {
+    edges {
+      node {
+        id
+        type
+        status
+        createdAt
+        completedAt
+      }
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+```
+
+### Mutations
+
+```graphql
+# Create a new organization
+mutation CreateOrg($input: CreateOrgInput!) {
+  createOrganization(input: $input) {
+    organization {
+      id
+      name
+      slug
+    }
+  }
+}
+```
+
+## Subscriptions
+
+Real-time job status updates are available via WebSocket subscriptions.
+
+```graphql
+subscription OnJobUpdate($jobId: ID!) {
+  jobStatusChanged(jobId: $jobId) {
+    status
+    progress
+    message
+  }
+}
+```
+
+## Introspection
+
+GraphQL introspection is enabled on non-production environments only.
+In production, use the published schema file from the CI artifacts.