infrastructure-project

Project Module

Multi-project discovery, validation, and metadata management.

Project Discovery (discovery.py)

from infrastructure.project import discover_projects, ProjectInfo

# Discover all valid projects in the repository
projects = discover_projects(repo_root)

for project in projects:
    print(f"{project.name}: {project.path}")
    print(f"  Has tests: {project.has_tests}")
    print(f"  Has manuscript: {project.has_manuscript}")

Structure Validation

from infrastructure.project import validate_project_structure

# Validate that a project has all required directories
is_valid, message = validate_project_structure(project_path)

Required directories:

• src/ — Project source code
• tests/ — Test suite

Optional (recommended) directories:

• scripts/ — Analysis scripts (thin orchestrators)
• manuscript/ — Markdown manuscript sections

Metadata Extraction

from infrastructure.project import get_project_metadata

# Extract project metadata from pyproject.toml and/or manuscript/config.yaml
metadata = get_project_metadata(project_path)
print(metadata.get("title"), metadata["version"], metadata["authors"])

Optional CodeGraph Helpers

CodeGraph is a local-only agent navigation index. Use these helpers to print safe commands and verify that a template-root index did not include private symlinked projects:

from pathlib import Path
from infrastructure.project import build_codegraph_init_command, verify_codegraph_scope_payload

print(build_codegraph_init_command(Path(".")).display)
offenders = verify_codegraph_scope_payload(codegraph_files_json)

The index directory .codegraph/ is generated local state and must remain untracked.

Rendered vs Non-Rendered Subfolders

• Rendered: projects/templates/ (public exemplars) and optional projects/active/ (hot-seat) — discovered and executed by infrastructure when present.
• Non-rendered: projects/working/ and projects/archive/ in the simplified sidecar; the optional legacy projects/active/ is also preserved but not executed.