Add four GitHub Actions for structure, docs consistency, AI-HPP audit, and auto-archive

[tryblackjack]

Motivation

• Enforce a minimal, predictable repo root so the project doesn't accumulate stray files.
• Keep documentation healthy by catching Markdown style and broken internal links early.
• Run lightweight AI-HPP standard and code linters to catch unsafe terms and style issues.
• Automatically archive unexpected root items to a dated archive/ folder to avoid destructive deletions.

Description

• Added four workflow files under .github/workflows: structure-validator.yml, spec-consistency.yml, hpp-standard-audit.yml, and auto-archive.yml with the exact logic provided.
• structure-validator.yml validates allowed root entries and required directories, failing the job on unexpected items or missing required folders.
• spec-consistency.yml installs markdownlint-cli, runs markdownlint across Markdown files, and checks for broken internal links.
• hpp-standard-audit.yml installs ruff and eslint, lints Python and JS locations if present, and scans repository files for forbidden and required AI-HPP keywords.
• auto-archive.yml scans the repo root and moves unexpected items into archive/<YYYY-MM-DD>/auto-archive to preserve data without deleting anything.
• The new workflows were created only if .github/workflows did not exist, and no existing repository files were removed or modified.

Testing

• Parsed each workflow YAML with Ruby YAML.safe_load to validate YAML syntax, and all files parsed successfully.
• Programmatically checked that only the four new workflow files were introduced to the repository changes, and no other files were altered.
• Verified that each workflow file contains the intended steps (checkout, installs, lint/audit or archive logic) as provided, and all automated checks passed.
• Summary status: all automated validations succeeded and the four workflows are installed successfully.

---

Codex Task

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 28e376529b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[chatgpt-codex-connector]

Remove unconditional missing-keyword gate

This audit rule makes the new workflow fail on every run because it requires safety_gate, state_lock, and signal_model to exist under spec/, but those strings are not present in the current repository content, so violations is always set and the job exits 1. That turns CI red for unrelated changes and blocks merges until either the spec is updated in the same change or this check is made non-blocking/conditional.

Useful? React with 👍 / 👎.

[chatgpt-codex-connector]

Parse markdown links correctly before existence checks

The link checker currently misclassifies valid links as broken: IFS='](' read leaves a leading ( in link, and the existence test is then done against that malformed value (and from repo root), so normal links/anchors in docs are flagged. In this repo, links such as (#purpose) and (architecture.md) in docs/ai-hpp-standard.md will fail despite being valid, causing the workflow to fail on healthy documentation.

Useful? React with 👍 / 👎.