Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: PALO Evidence Pack questions and feedback
url: https://github.com/sev7enITA/PALOframework/discussions
about: Use the canonical Discussion channel for questions, reviewer findings and activation feedback.
- name: Private security reporting
url: https://github.com/sev7enITA/PALOframework/security/advisories/new
about: Report vulnerabilities privately. Do not publish exploit details or secrets in an issue or Discussion.
62 changes: 62 additions & 0 deletions .github/activation/issues.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
[
{
"title": "[Case] Independently replay the agentic invoice gold case",
"labels": ["activation", "case", "good first issue"],
"body": "## Goal\nReplay the preloaded agentic invoice case from a clean clone and check whether the dossier distinguishes permission from verified effect.\n\n## Scope\nOne case only: `evidence-pack/cases/agentic-invoice-exception.case.json`. Do not propose a new module.\n\n## Acceptance criteria\n- Record setup time and time to the first local receipt.\n- Identify any ambiguous allowed or prohibited action.\n- Verify the receipt digest changes after a material case edit.\n- Report whether the dossier supports a proceed, pause or stop decision.\n\n## Safety boundary\nUse synthetic data only. Validation is not certification or production approval."
},
{
"title": "[Case] Review the HR learning assistant decision boundary",
"labels": ["activation", "case", "governance"],
"body": "## Goal\nReview whether the HR gold case cleanly separates optional learning support from employment decisions.\n\n## Scope\n`evidence-pack/cases/hr-learning-assistant.case.json` only.\n\n## Acceptance criteria\n- Identify one plausible prohibited inference not already named, or explain why the list is sufficient.\n- Check whether a reviewer can identify the accountable decision owner.\n- Propose one bounded evidence improvement.\n- Make no jurisdiction-wide legal conclusion."
},
{
"title": "[Case] Verify procurement gold-case sources and decision rights",
"labels": ["activation", "case", "documentation"],
"body": "## Goal\nCheck source freshness and decision rights in the procurement bid-summary gold case.\n\n## Scope\n`evidence-pack/cases/procurement-bid-summary.case.json` only.\n\n## Acceptance criteria\n- Verify every source URL and review date.\n- Confirm scoring and award authority remain outside the assistant boundary.\n- Add or propose one traceability check from bid source to summary.\n- Keep the example synthetic and non-production."
},
{
"title": "[Adapter] Accept a Case File from stdin in the local validator",
"labels": ["activation", "adapter", "good first issue"],
"body": "## Goal\nAllow `npm run evidence:validate -- -` to validate a Case File supplied through stdin.\n\n## Acceptance criteria\n- Existing file-path behavior remains unchanged.\n- Stdin input has a documented size limit and rejects invalid JSON clearly.\n- Receipt output remains local and deterministic for the same case content.\n- Add Node tests for valid, invalid and oversized input.\n\n## Non-goal\nNo network API or hosted upload."
},
{
"title": "[Adapter] Add an n8n export-to-Evidence-Pack example",
"labels": ["activation", "adapter", "n8n"],
"body": "## Goal\nCreate one isolated n8n example that exports a synthetic PALO Case File for local Evidence Pack validation.\n\n## Acceptance criteria\n- Uses the existing n8n developer-preview boundary.\n- Produces a Case File that passes `npm run case:contribute -- --validate-all`.\n- Requires no production credentials or personal data.\n- Documents that n8n orchestration does not itself verify the declared outcome.\n\n## Non-goal\nPublishing or claiming an n8n-verified community node."
},
{
"title": "[Threat test] Reject a validation receipt after case tampering",
"labels": ["activation", "threat-test", "security"],
"body": "## Goal\nAdd a negative test proving that a receipt no longer matches after a material Case File change.\n\n## Acceptance criteria\n- Start from the agentic invoice gold case and its receipt.\n- Change one authority or expected-effect field.\n- Demonstrate a digest mismatch with a deterministic test.\n- Document what the receipt does and does not protect.\n\n## Non-goal\nClaiming signer identity, non-repudiation or independent assurance."
},
{
"title": "[Threat test] Prove the browser Evidence Pack has no mandatory telemetry",
"labels": ["activation", "threat-test", "privacy"],
"body": "## Goal\nAdd a browser test that fails if the Evidence Pack sends case or receipt content over the network.\n\n## Acceptance criteria\n- Intercept browser requests after page load.\n- Complete the preloaded case, generate and download a receipt.\n- Assert no request contains case answers, receipt content or identifiers.\n- Allow only documented static asset requests required to load the page.\n- Record the tested browser and route."
},
{
"title": "[Threat test] Add a missing-authority negative gold-case fixture",
"labels": ["activation", "threat-test", "governance"],
"body": "## Goal\nShow that a structurally valid Case File can still be decision-misleading when authority boundaries are absent.\n\n## Acceptance criteria\n- Add one intentionally misleading educational fixture.\n- The base Case File schema may pass, but Evidence Pack readiness must fail or warn.\n- The result names the missing allowed action, prohibited action and verification method.\n- Add a test and plain-language explanation."
},
{
"title": "[Mapping] Review Evidence Pack claims against the EU AI Act source",
"labels": ["activation", "mapping", "governance"],
"body": "## Goal\nReview only the EU AI Act references and wording exposed by the three gold cases.\n\n## Acceptance criteria\n- Link each material regulatory statement to the exact official source location.\n- Separate source-backed statement, PALO interpretation and open applicability question.\n- Remove or narrow any overbroad claim.\n- Record the source check date.\n\n## Non-goal\nProviding legal advice or a complete compliance mapping."
},
{
"title": "[Mapping] Trace NIST and ISO references to Evidence Pack decisions",
"labels": ["activation", "mapping", "documentation"],
"body": "## Goal\nMake the NIST AI RMF and ISO/IEC 42001 references actionable for the exact Evidence Pack decisions they support.\n\n## Acceptance criteria\n- Map each reference to a named decision or evidence field.\n- Identify whether the source is official, standard or interpretive.\n- Add a review date and an applicability caveat.\n- Do not reproduce paywalled standards text."
},
{
"title": "[Accessibility] Complete the Evidence Pack with keyboard and screen reader",
"labels": ["activation", "accessibility", "good first issue"],
"body": "## Goal\nComplete the preloaded case and receipt flow without a pointer device.\n\n## Acceptance criteria\n- Test current Chrome or Firefox with one named screen reader.\n- Confirm logical heading order, field labels, focus order and live-region announcements.\n- Confirm every action has a visible focus state and at least a 44px target.\n- Report exact steps and one screenshot or accessibility-tree excerpt for each failure."
},
{
"title": "[Accessibility] Verify Evidence Pack at 390px and 200 percent zoom",
"labels": ["activation", "accessibility", "good first issue"],
"body": "## Goal\nVerify the complete Evidence Pack path on a 390px viewport and at 200 percent browser zoom.\n\n## Acceptance criteria\n- No horizontal page overflow.\n- Primary CTA, form, results, receipt actions and disclaimers remain visible and operable.\n- Text does not overlap or truncate material meaning.\n- Add a browser smoke assertion for any reproducible regression."
}
]
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,20 @@ and this project follows Semantic Versioning where practical.

## [Unreleased]

## [3.0.1] - 2026-08-12

### Added

- Added the preloaded local Evidence Pack experience, a voluntary SHA-256 validation receipt and three schema-valid gold cases.
- Added `case:contribute`, a one-command generator and validator for Community Casebook contributions and pull request preparation.
- Added the five-day activation runbook, 20-seat founding review protocol and public changed-because-of-feedback log.

### Changed

- Normalized tracked source and generated publication text to plain ASCII punctuation, separators and status labels.
- Added an automated text-style gate for source files, generated `dist` files and current Git metadata.
- Started a 30-day new-module freeze, enabled one canonical GitHub Discussions channel and added the five-day activation and changed-because-of-feedback records.
- Made PALO Evidence Pack the only primary website and README activation route while retaining existing modules as downstream tools.

## [3.0.0] - 2026-08-12

Expand Down
2 changes: 1 addition & 1 deletion CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ type: software
authors:
- family-names: "Degni"
given-names: "Fabrizio"
version: "3.0.0"
version: "3.0.1"
date-released: "2026-08-12"
license: MIT
repository-code: "https://github.com/sev7enITA/PALOframework"
Expand Down
24 changes: 24 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,30 @@ PALO v3 semantic sources are versioned public contracts. Change the semantic sou

First off, thank you for considering contributing to PALO!

## Fast path: contribute a case

During the 30-day activation freeze, the most valuable contribution is one synthetic or safely publishable Evidence Pack case. Generate the Case File and pull request body with:

```sh
npm run case:contribute -- \
--slug retail-returns-assistant \
--title "Retail returns assistant" \
--sector retail \
--scenario "An assistant drafts a recommendation while a named employee approves refunds." \
--community builders \
--author "@your-github-handle"
```

Complete the generated TODO fields, then run:

```sh
npm run case:contribute -- --validate-all
npm run evidence:test
npm run validate
```

The command does not push, open a pull request or transmit case content. Cases must state allowed and prohibited actions, an observable expected effect, an independent verification method and their non-production boundary.

## Table of Contents

- [Code of Conduct](#code-of-conduct)
Expand Down
4 changes: 2 additions & 2 deletions PALO_AIGovernance.html
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@
<meta name="twitter:card" content="summary_large_image">
<link rel="icon" type="image/webp" href="assets/logo.webp">
<link rel="stylesheet" href="assets/palo-icons.css">
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.0">
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.1">
<script src="assets/palo-icons.js"></script>
<script src="assets/palo-v21.js?v=3.0.0"></script>
<script src="assets/palo-v21.js?v=3.0.1"></script>
</head>
<body class="palo-v21">
<a class="palo-skip-link" href="#main-content">Skip to main content</a>
Expand Down
4 changes: 2 additions & 2 deletions PALO_AIProductionReadiness.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@
<meta name="description" content="Nine independently testable gates and cautious planning ranges from the PALO-AI developer preview to production candidates.">
<link rel="canonical" href="https://paloframework.org/PALO_AIProductionReadiness.html">
<link rel="icon" type="image/webp" href="assets/logo.webp">
<link rel="stylesheet" href="assets/palo-icons.css"><link rel="stylesheet" href="assets/palo-v21.css?v=3.0.0"><link rel="stylesheet" href="assets/palo-docs.css">
<script src="assets/palo-icons.js" defer></script><script src="assets/palo-v21.js?v=3.0.0" defer></script><script src="assets/palo-docs.js" defer></script>
<link rel="stylesheet" href="assets/palo-icons.css"><link rel="stylesheet" href="assets/palo-v21.css?v=3.0.1"><link rel="stylesheet" href="assets/palo-docs.css">
<script src="assets/palo-icons.js" defer></script><script src="assets/palo-v21.js?v=3.0.1" defer></script><script src="assets/palo-docs.js" defer></script>
</head>
<body class="palo-v21 palo-readiness-page">
<a class="palo-skip-link" href="#main-content">Skip to main content</a>
Expand Down
4 changes: 2 additions & 2 deletions PALO_AIQuickstarts.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,9 @@
/>
<link rel="icon" type="image/webp" href="assets/logo.webp" />
<link rel="stylesheet" href="assets/palo-icons.css" />
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.0" />
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.1" />
<script src="assets/palo-icons.js" defer></script>
<script src="assets/palo-v21.js?v=3.0.0" defer></script>
<script src="assets/palo-v21.js?v=3.0.1" defer></script>
<script src="assets/palo-ai-demo.js?v=2.5.0" defer></script>
</head>
<body class="palo-v21">
Expand Down
4 changes: 2 additions & 2 deletions PALO_AIWhy.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@
<link rel="canonical" href="https://paloframework.org/PALO_AIWhy.html" />
<link rel="icon" type="image/webp" href="assets/logo.webp" />
<link rel="stylesheet" href="assets/palo-icons.css" />
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.0" />
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.1" />
<script src="assets/palo-icons.js" defer></script>
<script src="assets/palo-v21.js?v=3.0.0" defer></script>
<script src="assets/palo-v21.js?v=3.0.1" defer></script>
<script src="assets/palo-ai-demo.js?v=2.5.0" defer></script>
</head>
<body class="palo-v21">
Expand Down
4 changes: 2 additions & 2 deletions PALO_AgenticCapabilityMatrix.html
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@
<link rel="canonical" href="https://paloframework.org/PALO_AgenticCapabilityMatrix.html">
<link rel="icon" type="image/webp" href="assets/logo.webp">
<link rel="stylesheet" href="assets/palo-icons.css">
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.0">
<link rel="stylesheet" href="assets/palo-v21.css?v=3.0.1">
<link rel="stylesheet" href="assets/palo-docs.css">
<script src="assets/palo-icons.js" defer></script>
<script src="assets/palo-v21.js?v=3.0.0" defer></script>
<script src="assets/palo-v21.js?v=3.0.1" defer></script>
<script src="assets/palo-docs.js" defer></script>
</head>
<body class="palo-v21 palo-matrix-page">
Expand Down
2 changes: 1 addition & 1 deletion PALO_AgenticGovernance.html
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
<link rel="stylesheet" href="agentic/style.css">
<link rel="stylesheet" href="assets/palo-icons.css">
<script src="assets/palo-icons.js"></script>
<script src="assets/palo-v21.js?v=3.0.0"></script>
<script src="assets/palo-v21.js?v=3.0.1"></script>
<script src="assets/palo-case-file.js?v=2.4.1"></script>
</head>
<body>
Expand Down
Loading
Loading