feat: support index.md as section file

[klocke-io]

Summary

• Adds proposal to extend docforge's hardcoded _index.md section file detection to also recognize index.md
• VitePress and other modern SSGs use index.md as section index — currently this bypasses the sectionFile special case in resolveManifestLinks, breaking overlay manifests silently
• The docsy plugin already handles both names (plugin.go:22), confirming this was a known gap

Motivation

When downstream repos migrate from Hugo to VitePress and rename _index.md → index.md, docforge no longer auto-generates the section index from frontmatter. Instead it treats it as a normal file, resolves its source, and fetches real content — overwritingl section metadata.

Proposal

Minimal approach: add an isSectionFile(name string) bool helper that matches both _index.md and index.md, update the 5 affected call sites. Full details in the proposal document.

Test plan

• Review proposal at openspec/changes/support-index-md-as-section-file/proposal.md
• Discuss approach and approve before implementation

[gardener-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kostov6 for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[n-boshnakov]

Other than some minor comments, the specs sound good to me.

As a side note (see comment), should we also consider adding a way to do the same section file recognition for README.md files? Perhaps as a new feature in the future?

[n-boshnakov]

Should we include the same scenario for a "Node with file _index.md ...", as every other scenario comes in "pairs"?

[n-boshnakov]

Do we actually want to also include "README.md" and "readme.md" as index files as well? Some repositories we ingest use that naming convention instead of "index.md".