Skip to content

Document module-level AI involvement and provenance - #191

Merged
sancarn merged 9 commits into
masterfrom
docs/ai-provenance
Nov 11, 2026
Merged

sancarn merged 9 commits into
masterfrom
docs/ai-provenance

Conversation

@sancarn

@sancarn sancarn commented Nov 10, 2026 •

Copy link
Copy Markdown
Owner

stdVBA needs scoped module-level AI disclosure: a legacy class with an AI-written fix must not be described as wholly AI-made. Add @ai, @aidate and @aidesc guidance, source metadata and generated documentation.

  • @aidate records the earliest evidenced AI contribution to retained work, using an edit timestamp or matched commit date; it is not proof that earlier AI use never occurred.
  • @aidesc identifies the AI-written changes, older/upstream work that is not attributed to AI, and uncertainty about human scrutiny.
  • AI:W is supported for stdCallback, stdEnumerator, stdHTML, stdWebView, stdWindow and WIP/stdShell. AI:X is retained only for the maintainer-confirmed native thunk component in stdRegex. Fourteen other classes retain dates/descriptions but have no @ai mark because W/X remains unresolved. The other 73 modules lack sufficient authorship evidence.
  • stdRegex separates the upstream sihlfall pure VBA engine from AI-assisted integration and its AI:X native thunk. stdLambda's retained AI fix is distinguished from unmerged native experiments. Deletion-only fixes, including stdCallback's removed error handler, are checked using commit diffs rather than surviving-line blame alone.

The audit in docs/ai-provenance.json covers all 94 source modules. Class-name searches span every line of 43 indexed Codex logs, all 53 Cursor workspace headers/composer bodies/stored messages (including seven explore subagents), and 40 available Cursor transcript files. Blame on baseline 8ec0a13, author/committer dates and commit diffs were cross-checked against conversations for all 21 disclosed classes. Direct edits, implementation workflows and PR-only provenance are distinguished. One untitled Cursor record has no stored messages. Disclosure/history-lookup conversations, copied upstream code and unmerged experiments are not used to infer current AI authorship. No private transcripts, local identifiers or billing data are published.

VBDocsGen validates marks, real ISO calendar dates, nonempty descriptions and duplicate module tags, exposing optional ai, aiDate and aiDescription fields. Validation passed for all four marks, valid/invalid leap dates, malformed dates, empty descriptions, duplicate tags, absent marks and unresolved classifications. Generated docs preserve existing API members, signatures, descriptions and examples. All source/audit/generated metadata agree; full-PR VBA changes are comments only. UTF-8, CRLF byte checks and whitespace checks passed. Existing unrelated generator warnings remain. No Office tests/settings changes were needed.

Compatibility: no breaking changes identified. VBA APIs/runtime behavior are unchanged; docs.json gains optional metadata fields.

Created with gpt-6.1-sol in T3 Code (Codex harness).

AI descriptions use direct declarations of AI use, manual review and component scope. Retrospective methods and provenance qualifications stay in the audit, rather than in module descriptions. Classification marks and dates are unchanged by this wording pass.

@sancarn
sancarn merged commit 4e00a1d into master Nov 11, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant