AHI-Factory v1.0.1

AHI-Factory is the shared Artifact Factory for the AHI ecosystem. It is installed once and reused by repositories such as AHI-Philosophy, AHI-P, AHI-O, AHI-G, and future AHI repositories.

Architecture

AHI Repository
  └─ ahi.config.yaml + specs/
            ↓
      AHI-Factory v1
            ↓
   Validate → Generate → Check
            ↓
 Markdown + Ontology Index + Manifest
            ↓
      GitHub Actions

The consumer repository owns content and specifications. AHI-Factory owns generation, validation, indexing, and reusable automation. Consumer repositories must not duplicate Factory source code.

v1.0.1 capabilities

• Validate repository configuration and canonical Entity specs.
• Validate canonical status, IDs, sources, and related entities.
• Deterministically generate Markdown with YAML front matter.
• Preserve YAML lists using - syntax and nested Markdown code fences.
• Generate the Ontology Index.
• Generate a machine-readable manifest with SHA-256 hashes.
• check mode detects modified or missing generated files without writing them.
• Local CLI: validate, generate, check.
• Reusable GitHub Workflow in .github/workflows/ahi-factory.yml.
• Reusable Composite Action in actions/artifact-factory/action.yml.
• Example consumer configuration for AHI-Philosophy.
• Automated tests.

Consumer repository model

AHI-Philosophy/
├── ahi.config.yaml
├── specs/ontology/*.yaml
└── 02-ONTOLOGY/*.md        # generated artifacts

The generated Markdown must not be hand-edited. Change the YAML specification and regenerate.

GitHub reuse

Reusable workflow location:

.github/workflows/ahi-factory.yml

Caller example:

jobs:
  factory:
    uses: YOUR-OWNER/AHI-Factory/.github/workflows/ahi-factory.yml@v1
    with:
      command: generate
      commit: true
      factory_repository: YOUR-OWNER/AHI-Factory

For private repositories, configure the called repository's Actions access policy so approved repositories may call the reusable workflow. Pin production consumers to a release tag such as v1 or a specific immutable ref.

License

GNU Affero General Public License v3.0 (AGPL-3.0).