Skip to content

Add CRA Conformity Assessment Process and Open Source Policy conformity; improve architecture doc cross-references and typedoc coverage#1289

Merged
pethers merged 9 commits intomainfrom
copilot/update-architecture-security-docs
Mar 19, 2026
Merged

Add CRA Conformity Assessment Process and Open Source Policy conformity; improve architecture doc cross-references and typedoc coverage#1289
pethers merged 9 commits intomainfrom
copilot/update-architecture-security-docs

Conversation

Copy link
Contributor

Copilot AI commented Mar 19, 2026

  • Analyze CRA_Conformity_Assessment_Process.md from ISMS-PUBLIC
  • Analyze Open_Source_Policy.md from ISMS-PUBLIC
  • Audit current CRA-ASSESSMENT.md against both policies
  • Add Open Source Policy Conformity section to CRA-ASSESSMENT.md (7 subsections covering all OSP §1-§7 requirements with evidence)
  • Add CRA Conformity Assessment Process Alignment section to CRA-ASSESSMENT.md (9-step process matrix + classification badges)
  • Add CRA_Conformity_Assessment_Process.md reference to CRA-ASSESSMENT.md ISMS Policy Framework
  • Update CRA-ASSESSMENT.md Purpose & Scope to reference both policies
  • Update CRA-ASSESSMENT.md Document Control with policy alignment lines and updated dates (v1.1)
  • Add ISMS Policy References table to SECURITY_ARCHITECTURE.md Related Documents section
  • Add CRA_Conformity_Assessment_Process.md to SECURITY_ARCHITECTURE.md governance policy table
  • Add Open_Source_Policy and CRA_Conformity_Assessment_Process to THREAT_MODEL.md ISMS policies
  • Add ISMS Policy Alignment section to README.md Security Documentation
  • Fix CIA triad Availability classification inconsistency: aligned CRA-ASSESSMENT.md Classification Selections from "Moderate" → "High" to match README.md and OSP §5 declaration (per Hack23 ISMS CLASSIFICATION.md)
  • Fix FUTURE_THREAT_MODEL.md next review date from 2026-06-19 → 2026-05-19 to align with quarterly review cycle (Feb, May, Aug, Nov)
  • Code review passed (0 comments)
  • CodeQL security scan passed (0 alerts)

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@github-actions github-actions bot added the size-xs Extra small change (< 10 lines) label Mar 19, 2026
@github-actions
Copy link
Contributor

🏷️ Automatic Labeling Summary

This PR has been automatically labeled based on the files changed and PR metadata.

Applied Labels: size-xs

Label Categories

  • 🗳️ Content: news, dashboard, visualization, intelligence
  • 💻 Technology: html-css, javascript, workflow, security
  • 📊 Data: cia-data, riksdag-data, data-pipeline, schema
  • 🌍 I18n: i18n, translation, rtl
  • 🔒 ISMS: isms, iso-27001, nist-csf, cis-controls
  • 🏗️ Infrastructure: ci-cd, deployment, performance, monitoring
  • 🔄 Quality: testing, accessibility, documentation, refactor
  • 🤖 AI: agent, skill, agentic-workflow

For more information, see .github/labeler.yml.

@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

…elated Documents sections to architecture docs

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@github-actions github-actions bot added documentation Documentation updates size-l Large change (250-1000 lines) labels Mar 19, 2026
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

…GRAM.md, FUTURE_SECURITY_ARCHITECTURE.md; fix FUTURE_ARCHITECTURE.md references

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@github-actions github-actions bot added security Security improvements isms ISMS compliance changes labels Mar 19, 2026
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

…tions

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Copilot AI changed the title [WIP] Update architecture and security documents for compliance Update architecture/security docs for ISMS compliance; improve typedoc coverage Mar 19, 2026
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

…ty to CRA-ASSESSMENT.md, update cross-references in SECURITY_ARCHITECTURE.md, THREAT_MODEL.md, README.md

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@github-actions github-actions bot added iso-27001 ISO 27001 controls nist-csf NIST CSF compliance cis-controls CIS Controls labels Mar 19, 2026
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

Copilot AI changed the title Update architecture/security docs for ISMS compliance; improve typedoc coverage Add CRA Conformity Assessment Process and Open Source Policy conformity; improve architecture doc cross-references and typedoc coverage Mar 19, 2026
@pethers pethers marked this pull request as ready for review March 19, 2026 10:06
Copilot AI review requested due to automatic review settings March 19, 2026 10:06
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR strengthens ISMS/CRA conformity evidence across the repository’s architecture and security documentation while expanding TypeDoc configuration and API documentation navigation to improve internal/external traceability.

Changes:

  • Added CRA Conformity Assessment Process + Open Source Policy conformity/alignment content and expanded cross-references across architecture/security docs.
  • Expanded FUTURE_THREAT_MODEL.md with attacker-centric analysis, attack trees, kill chain disruption, and LLM/workflow threat matrices.
  • Updated TypeDoc configuration (custom tags, navigation links, visibility settings) and TypeDoc tsconfig exclude globs; refreshed docs/API_README.md.

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
typedoc.json Updates TypeDoc branding, block tags, navigation/sidebar links, and inclusion settings for broader API coverage.
tsconfig.typedoc.json Refines exclude patterns (glob-based) for TypeDoc compilation scope.
THREAT_MODEL.md Adds ISMS policy links for Open Source Policy and CRA Conformity Assessment Process.
SWOT.md Adds “Hack23 ISMS Policies” cross-reference section.
STATEDIAGRAM.md Adds “Hack23 ISMS Policies” cross-reference section.
SECURITY_ARCHITECTURE.md Adds ISMS policy reference table and CRA policy entry in policy inventory.
README.md Adds an “ISMS Policy Alignment” section with direct links to key policies.
MINDMAP.md Adds “Hack23 ISMS Policies” cross-reference section.
FUTURE_THREAT_MODEL.md Major expansion: attacker-centric modeling, attack trees, kill chain analysis, AI/LLM threat mapping, and monitoring KPIs.
FUTURE_SWOT.md Adds “Related Documents” architecture portfolio table + ISMS policy links.
FUTURE_STATEDIAGRAM.md Adds “Related Documents” architecture portfolio table + ISMS policy links.
FUTURE_SECURITY_ARCHITECTURE.md Adds architecture portfolio cross-reference table.
FUTURE_MINDMAP.md Adds “Related Documents” architecture portfolio table + ISMS policy links.
FUTURE_DATA_MODEL.md Adds “Related Documents” architecture portfolio table + ISMS policy links.
FUTURE_ARCHITECTURE.md Marks multiple future-doc entries as active and links them to the correct files.
FLOWCHART.md Adds “Related Documents” architecture portfolio table + ISMS policy links.
docs/API_README.md Expands compliance + architecture portfolio tables and adds ISMS policy references.
CRA-ASSESSMENT.md Adds Open Source Policy conformity evidence + CRA Conformity Assessment Process alignment matrix; updates versioning metadata.
ARCHITECTURE.md Adds “Related Documents” + ISMS policy/references and bumps document control version/date.
.gitignore Adds an api/ ignore rule (currently problematic given existing /api/ and docs/api/ usage).


| Requirement | Status | Evidence |
|------------|--------|---------|
| **CIA Triad Classification** | ✅ Declared | Public / High Integrity / High Availability |
@pethers
Copy link
Member

pethers commented Mar 19, 2026

@copilot apply changes based on the comments in this thread follow hack23 isms classification

…ISMS CLASSIFICATION.md

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 19, 2026

@copilot apply changes based on the comments in this thread follow hack23 isms classification

Fixed in 9221b08. Aligned the CRA-ASSESSMENT.md Classification Selections table Availability from "Moderate" → "High" to match the README.md declaration (High — 99.998% design availability with AWS CloudFront multi-region + GitHub Pages DR, automated failover) and the OSP §5 CIA Triad declaration ("Public / High Integrity / High Availability"), per Hack23 ISMS CLASSIFICATION.md availability levels.

@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

@pethers pethers requested a review from Copilot March 19, 2026 10:27
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates Riksdagsmonitor’s compliance and architecture documentation to explicitly align with Hack23 ISMS policies (notably Open Source Policy and CRA Conformity Assessment Process), while also improving TypeDoc configuration/coverage and documentation cross-linking across the architecture portfolio.

Changes:

  • Expand CRA and ISMS policy conformity content across CRA-ASSESSMENT.md, README.md, SECURITY_ARCHITECTURE.md, and THREAT_MODEL.md.
  • Add/standardize “Related Documents” + ISMS policy reference sections across multiple current/future architecture documents.
  • Adjust TypeDoc + tsconfig settings and related repo hygiene (e.g., ignore generated output).

Reviewed changes

Copilot reviewed 19 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
typedoc.json Refines TypeDoc branding, navigation links, tags, and visibility/sorting to improve generated API docs coverage.
tsconfig.typedoc.json Tightens exclude globs for dashboard scripts and keeps generated api output excluded from compilation.
THREAT_MODEL.md Adds explicit links to Open Source Policy and CRA Conformity Assessment Process in ISMS policy references.
SWOT.md Adds a Hack23 ISMS policies reference section for consistency with the architecture portfolio.
STATEDIAGRAM.md Adds a Hack23 ISMS policies reference section for consistency with the architecture portfolio.
SECURITY_ARCHITECTURE.md Adds a dedicated ISMS Policy References table and includes CRA Conformity Assessment Process in governance table.
README.md Adds an “ISMS Policy Alignment” section under security documentation.
MINDMAP.md Adds a Hack23 ISMS policies reference section for consistency with the architecture portfolio.
FUTURE_THREAT_MODEL.md Major expansion with future attacker/attack-surface content, plus broader related-doc links and updated document control metadata.
FUTURE_SWOT.md Adds a related-documents section and Hack23 ISMS policy references.
FUTURE_STATEDIAGRAM.md Adds a related-documents section and Hack23 ISMS policy references.
FUTURE_SECURITY_ARCHITECTURE.md Adds a consolidated “Architecture Portfolio” cross-reference table.
FUTURE_MINDMAP.md Adds a related-documents section and Hack23 ISMS policy references.
FUTURE_DATA_MODEL.md Adds a related-documents section and Hack23 ISMS policy references.
FUTURE_ARCHITECTURE.md Updates portfolio table items from “planned” to “active” and adds missing links to existing future docs.
FLOWCHART.md Adds a related-documents section and Hack23 ISMS policy references.
docs/API_README.md Reworks compliance/architecture doc pointers into structured tables and adds explicit ISMS policy links.
CRA-ASSESSMENT.md Adds Open Source Policy conformity section and CRA Conformity Assessment Process alignment matrix + updates document control.
ARCHITECTURE.md Adds related-documents + ISMS policy references and bumps version/date metadata.
.gitignore Adds an ignore entry for api/ (TypeDoc output), though an equivalent rule already exists.

**✅ Approved by:** James Pether Sörling, CEO
**🔄 Review Cycle:** Quarterly (Feb, May, Aug, Nov)
**⏰ Next Review:** 2026-05-26
**⏰ Next Review:** 2026-06-19
@pethers
Copy link
Member

pethers commented Mar 19, 2026

@copilot apply changes based on the comments in this thread

…ule (May not June)

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Mar 19, 2026

@copilot apply changes based on the comments in this thread

Fixed in 80f2ab8. Aligned FUTURE_THREAT_MODEL.md next review date from 2026-06-19 → 2026-05-19 to match the stated quarterly review cycle (Feb, May, Aug, Nov).

@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

@pethers pethers merged commit 1af49ae into main Mar 19, 2026
11 checks passed
@pethers pethers deleted the copilot/update-architecture-security-docs branch March 19, 2026 10:53
@github-actions
Copy link
Contributor

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cis-controls CIS Controls documentation Documentation updates isms ISMS compliance changes iso-27001 ISO 27001 controls nist-csf NIST CSF compliance security Security improvements size-l Large change (250-1000 lines) size-xs Extra small change (< 10 lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants