Skip to content

feat(traceability): add aidlc-traceability matrix tool#236

Merged
harmjeff merged 6 commits into
awslabs:mainfrom
harmjeff:feature/traceability
May 13, 2026
Merged

feat(traceability): add aidlc-traceability matrix tool#236
harmjeff merged 6 commits into
awslabs:mainfrom
harmjeff:feature/traceability

Conversation

@harmjeff
Copy link
Copy Markdown
Contributor

@harmjeff harmjeff commented May 1, 2026

Summary

  • Adds the aidlc-traceability tool under scripts/aidlc-traceability/ — a Python-based traceability matrix tool that parses stories, requirements, components, units, and code to generate HTML and Markdown traceability reports
  • Includes full source (src/), test suite (tests/), documentation (docs/), and requirements artifacts (requirements/)
  • All security scans passed clean prior to merge

Security scan results

Tool Status Findings
Semgrep OSS ✅ Clean 0 findings, 290 rules, 27 files
Bandit ✅ Clean 0 issues, 2,155 lines scanned
Checkov ✅ Clean 0 failed checks
gitleaks ✅ Clean No secrets leaked
CodeQL ✅ Clean 0 findings, 174 security + quality queries
Grype ⚠️ 1 informational pip 26.0.1 GHSA-58qw-9mgm-455v (Medium, no fix available, not in traceability source)

Test plan

  • Review source structure under scripts/aidlc-traceability/src/traceability/
  • Run test suite: cd scripts/aidlc-traceability && uv run pytest
  • Verify CLI entry point works as expected per README.md
  • Confirm security scan results above are acceptable

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

Introduces the traceability matrix tool under scripts/aidlc-traceability/,
including source, tests, docs, and requirements. Verified clean across
Semgrep, Bandit, Checkov, gitleaks, Grype, and CodeQL (174 queries).

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@harmjeff harmjeff requested a review from a team as a code owner May 1, 2026 15:57
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label May 1, 2026
Copy link
Copy Markdown

@github-advanced-security github-advanced-security AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Semgrep OSS found more than 20 potential problems in the proposed changes. Check the Files changed tab for more details.

@scottschreckengaust scottschreckengaust added the enhancement New feature or request label May 1, 2026
harmjeff and others added 2 commits May 1, 2026 13:10
Fix 1,205 MD060 table alignment errors, MD040 missing code fence
languages, MD025 multiple H1 headings, and MD041 missing first-line H1
across all 17 markdown files in scripts/aidlc-traceability/.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@harmjeff harmjeff enabled auto-merge May 5, 2026 15:58
Scan the entire scripts/ directory instead of aidlc-evaluator only,
so new tools are covered automatically without workflow changes.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the github label May 5, 2026
Copy link
Copy Markdown
Member

@scottschreckengaust scottschreckengaust left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Copy Markdown

@ayushtr-aws ayushtr-aws left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@harmjeff harmjeff added this pull request to the merge queue May 13, 2026
Merged via the queue into awslabs:main with commit c8e3522 May 13, 2026
23 of 36 checks passed
@harmjeff harmjeff deleted the feature/traceability branch May 13, 2026 21:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request github

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants