From d7e94086665a08b33a1a1c78bb98427d66a78dec Mon Sep 17 00:00:00 2001 From: Sage Hart - Creative Studio Date: Sat, 14 Nov 2026 16:14:21 -0600 Subject: [PATCH] Align APS repository and discovery with guided investigation --- .github/ISSUE_TEMPLATE/bug.yml | 23 ++- .github/ISSUE_TEMPLATE/config.yml | 7 + .github/ISSUE_TEMPLATE/proposal.yml | 34 ++++ .github/ISSUE_TEMPLATE/question.yml | 15 +- .github/PULL_REQUEST_TEMPLATE.md | 7 +- .github/workflows/repository-checks.yml | 6 +- AGENTS.md | 46 +++++ CITATION.cff | 24 +++ CODE_OF_CONDUCT.md | 2 +- CONTRIBUTING.md | 44 ++++- README.md | 176 ++++++------------ SECURITY.md | 12 +- SUPPORT.md | 19 +- apps/aps-demo/index.html | 72 ++++--- apps/aps-demo/public/guide.html | 88 +++++++++ apps/aps-demo/public/llms.txt | 35 ++++ apps/aps-demo/public/sitemap.xml | 1 + apps/aps-demo/public/social-preview.jpg | Bin 0 -> 97050 bytes apps/aps-demo/scripts/e2e.mjs | 61 +++++- apps/aps-demo/scripts/seo.mjs | 85 +++++++-- apps/aps-demo/scripts/seo.test.mjs | 64 +++++++ apps/aps-demo/scripts/static.mjs | 8 +- apps/aps-demo/scripts/validation-evidence.mjs | 2 +- apps/aps-demo/src/App.tsx | 6 +- apps/aps-demo/src/domain/README.md | 36 +++- apps/aps-demo/src/styles.css | 1 + apps/aps-demo/src/views.test.tsx | 14 ++ docs/ARCHITECTURE.md | 19 +- docs/DEVELOPMENT_REFERENCE.md | 75 ++++++++ docs/GOVERNANCE_ARCHITECTURE.md | 6 +- docs/METHODOLOGY.md | 12 +- docs/README.md | 109 +++++++++++ docs/SEO.md | 48 ++++- docs/THREAT_MODEL.md | 12 +- docs/USER_GUIDE.md | 92 +++++++++ docs/VISION.md | 50 +++++ docs/assets/README.md | 9 + docs/assets/aps-comparison.jpg | Bin 0 -> 97050 bytes docs/open-source-readiness.md | 43 ++++- scripts/verify-linux-ci-evidence.mjs | 4 +- scripts/verify-linux-ci-evidence.test.mjs | 14 +- scripts/verify-linux-predeploy-evidence.mjs | 8 +- .../verify-linux-predeploy-evidence.test.mjs | 20 +- scripts/verify-repository-readiness.mjs | 30 ++- scripts/verify-repository-readiness.test.mjs | 8 +- 45 files changed, 1208 insertions(+), 239 deletions(-) create mode 100644 .github/ISSUE_TEMPLATE/proposal.yml create mode 100644 AGENTS.md create mode 100644 CITATION.cff create mode 100644 apps/aps-demo/public/guide.html create mode 100644 apps/aps-demo/public/llms.txt create mode 100644 apps/aps-demo/public/social-preview.jpg create mode 100644 apps/aps-demo/scripts/seo.test.mjs create mode 100644 docs/README.md create mode 100644 docs/USER_GUIDE.md create mode 100644 docs/VISION.md create mode 100644 docs/assets/README.md create mode 100644 docs/assets/aps-comparison.jpg diff --git a/.github/ISSUE_TEMPLATE/bug.yml b/.github/ISSUE_TEMPLATE/bug.yml index 2df691e..212b6f4 100644 --- a/.github/ISSUE_TEMPLATE/bug.yml +++ b/.github/ISSUE_TEMPLATE/bug.yml @@ -1,19 +1,36 @@ name: Bug report -description: Report a reproducible sandbox defect without sensitive data. +description: Report a reproducible app, documentation or research-implementation defect. body: - type: markdown attributes: - value: "For vulnerabilities follow SECURITY.md. Never post secrets, operational data or blind reference answers." + value: "For vulnerabilities follow SECURITY.md privately. Use synthetic examples; never post secrets, operational data or confidential reference answers. Review discussion exports before sharing them." + - type: dropdown + id: component + attributes: + label: Affected area + options: + - Guided browser experience + - Recorded evidence or source relationship + - Research engine, gateway or policy + - Documentation, build or repository + validations: + required: true - type: textarea id: reproduction attributes: label: Synthetic reproduction and environment - description: Include revision, OS, runtime versions and exact commands. + description: "For the app: route, case, inputs, ordered actions, browser/OS and viewport. For local code: commit, runtime versions and exact commands." validations: required: true - type: textarea id: behavior attributes: label: Expected and actual behavior + description: Explain what should happen and what you observed. Identify illustrative results versus recorded trials where relevant. validations: required: true + - type: textarea + id: evidence + attributes: + label: Safe supporting evidence + description: Optional screenshot, minimal log or source link. Redact sensitive content and keep the request or run identity if it explains the defect. diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 3ba13e0..4740467 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1 +1,8 @@ blank_issues_enabled: false +contact_links: + - name: APS user guide + url: https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/USER_GUIDE.md + about: Follow the comparison, decision path and reasoning workflow before opening a usage issue. + - name: Report a vulnerability privately + url: https://github.com/SafetyMP/Agentic-Process-Safety/security/advisories/new + about: Keep vulnerability details and sensitive evidence out of public issues. diff --git a/.github/ISSUE_TEMPLATE/proposal.yml b/.github/ISSUE_TEMPLATE/proposal.yml new file mode 100644 index 0000000..ef65e8a --- /dev/null +++ b/.github/ISSUE_TEMPLATE/proposal.yml @@ -0,0 +1,34 @@ +name: Research or design proposal +description: Propose a clearer investigation, case, control or evidence question. +body: + - type: markdown + attributes: + value: "Connect the proposal to APS's comparison → causal explanation → human reasoning experience. Proposed controls and new scenarios are not verified safeguards. Keep sensitive and blinded material private." + - type: textarea + id: problem + attributes: + label: Problem or research question + description: Who encounters the problem, in which case or workflow, and why does it matter? + validations: + required: true + - type: textarea + id: proposal + attributes: + label: Proposed change and alternative + description: What should change? Name a reasonable alternative or a competing explanation. + validations: + required: true + - type: textarea + id: evidence + attributes: + label: Supporting evidence and open questions + description: Link the actual source or observation. Distinguish modeled behavior, recorded trials, authored hypotheses and evidence still needed. + validations: + required: true + - type: textarea + id: acceptance + attributes: + label: How to assess the improvement + description: What observation would support the change, and what result would show it did not help? Separate implementation checks from user-learning or method-effectiveness claims. + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/question.yml b/.github/ISSUE_TEMPLATE/question.yml index 7345333..1392f4a 100644 --- a/.github/ISSUE_TEMPLATE/question.yml +++ b/.github/ISSUE_TEMPLATE/question.yml @@ -1,13 +1,18 @@ -name: Question or proposal -description: Ask a usage question or propose a focused improvement. +name: Usage or evidence question +description: Ask about the guided app, local development or what an observation establishes. body: - type: markdown attributes: - value: "Read README.md and SUPPORT.md. Keep vulnerabilities and confidential pilot evidence private." + value: "Start with README.md, docs/USER_GUIDE.md and SUPPORT.md. Keep vulnerabilities and confidential pilot evidence private." - type: textarea id: context attributes: - label: Question, context and proposed outcome - description: Include documentation consulted and a synthetic example. + label: Question and context + description: Include the documentation consulted and the case, route, command or evidence record you mean. Use a synthetic example. validations: required: true + - type: textarea + id: interpretation + attributes: + label: Your current interpretation + description: What do you think the result means, and which distinction or missing fact needs clarification? diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index e9fd349..07a7019 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -1,15 +1,18 @@ ## Problem and change -Describe the concrete problem, resulting behavior and scope. Link a sanitized issue where applicable. +Describe the concrete problem and resulting behavior. Identify the affected experience or research contract and link a sanitized issue where applicable. + +For an investigation change, explain what the user can now compare, inspect or decide. Distinguish a presentation change from a change to the model, recorded evidence or an operational control. ## Validation -List exact commands and actual results, including failures and missing prerequisites. Explain coverage. Include safe visual evidence for UI changes. +List exact commands and actual results, including failures and missing prerequisites. Explain coverage and independent review where applicable. Include safe visual evidence for UI changes; state which viewport, theme and interaction it shows. A local check does not establish publication or deployment. ## Review checklist - [ ] I have authority to contribute under Apache-2.0 and preserved third-party terms. - [ ] No secrets, operational/private data or blind reference answers are included. - [ ] Recorded evidence, human approvals and blinding/exposure records remain truthful. +- [ ] Retained comparison identity, reasoning and the separation of recommendation from authority remain intact where affected. - [ ] Dependencies, lockfiles, docs and tests are consistent; pinned gates remain intact. - [ ] Limitations and pending owner decisions are explicit; no production safety claim is implied. diff --git a/.github/workflows/repository-checks.yml b/.github/workflows/repository-checks.yml index 8d0f459..851d2f3 100644 --- a/.github/workflows/repository-checks.yml +++ b/.github/workflows/repository-checks.yml @@ -55,7 +55,7 @@ jobs: github.event.pull_request.base.ref == 'main' && github.event.pull_request.base.repo.full_name == github.repository && github.event.pull_request.head.repo.full_name == github.repository && - (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation') + (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation' || github.event.pull_request.head.ref == 'codex/aps-repository-alignment') run: node apps/aps-demo/scripts/qa-evidence.mjs - name: Record actual PR checkout and workflow identities id: validation @@ -81,7 +81,7 @@ jobs: github.event.pull_request.base.ref == 'main' && github.event.pull_request.base.repo.full_name == github.repository && github.event.pull_request.head.repo.full_name == github.repository && - (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation') + (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation' || github.event.pull_request.head.ref == 'codex/aps-repository-alignment') run: node apps/aps-demo/scripts/validation-evidence.mjs finalize - name: Retain predeployment evidence including failed runs if: >- @@ -89,7 +89,7 @@ jobs: github.event.pull_request.base.ref == 'main' && github.event.pull_request.base.repo.full_name == github.repository && github.event.pull_request.head.repo.full_name == github.repository && - (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation') + (github.event.pull_request.head.ref == 'release/aps-github-validation-v1' || github.event.pull_request.head.ref == 'codex/aps-redesign-release' || github.event.pull_request.head.ref == 'codex/aps-guided-investigation' || github.event.pull_request.head.ref == 'codex/aps-repository-alignment') uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7.0.2; ordinary artifact only with: name: aps-predeploy-${{ steps.validation.outputs.checkout_sha || github.sha }}-${{ github.run_id }}-${{ github.run_attempt }} diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..6687900 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,46 @@ +# Working in APS + +APS is a research sandbox for investigating agent workflow failures through same-request comparisons, concrete causal paths, source-linked evidence and human reasoning. Read [README.md](README.md), [the vision](docs/VISION.md) and [the documentation map](docs/README.md) before substantial changes. The [user guide](docs/USER_GUIDE.md) describes the current app. Historical plans and receipts describe their own revisions; they are not current acceptance evidence. + +## Find the owning source + +| Concern | Source | +| --- | --- | +| App routes and shared investigation state | `apps/aps-demo/src/App.tsx`, `routes/`, `components/SessionContext.tsx` | +| Cases, immutable comparisons, saved reasoning and causal wording | `apps/aps-demo/src/domain/cases.ts`, `comparison.ts`, `session.ts`, `presentation.ts` | +| Fixed illustrative checks and retained legacy simulation | `apps/aps-demo/src/domain/simulation.ts` | +| Recorded public snapshots and source mapping | `apps/aps-demo/src/fixtures/`, `apps/aps-demo/src/data.ts` | +| HAZOP screening, gateway and procurement research | `packages/engine/`, `packages/governance/`, `packages/simulator/`, `policies/`, `schemas/`, `tests/` | +| Build/publication and evidence checks | `apps/aps-demo/scripts/`, `scripts/verify-linux-predeploy-evidence.mjs`, `scripts/verify-linux-ci-evidence.mjs`, `.github/workflows/` | + +Inspect the implementation and its focused tests before changing a contract. The React/TypeScript app uses Vite and one root npm lockfile. The separate Python/OPA research runtime is not a browser backend. Preserve these stacks unless the task explicitly changes them. + +## Invariants + +- Evaluate comparison lanes from the same immutable request and baseline. Input edits create a draft; they must not relabel retained results. Reasoning belongs to its selected run. +- Keep modeled outcomes, recorded trials, proposed hazards and human discussion separate. A recommendation or ready status grants no authority. A hypothetical recovery must retain the denied parent and name its starting state. +- Derive causal descriptions from the actual case and retained inputs. Passing approval freshness does not establish quotation validity, inventory truth or purchase necessity. An objective-conflict review is not objective arbitration. +- Preserve frozen fixture bytes, source provenance and historical receipts. The production gate protects the original research trees and exact approved additions. Do not alter a manifest, pin, assertion count or allowlist merely to make a failing check pass. +- Keep the published app static: no credentials, operational data, backend calls, telemetry or unreviewed external assets. Discussion exports can contain free text; do not publish them as test evidence without inspection. +- Preserve existing user work and generated evidence. Do not turn historical approvals, exposed reference material or previous successful runs into current authorization or independent validation. + +## Checks and delivery + +Run commands from the repository root. See [Contributing](CONTRIBUTING.md) for the change-to-check mapping and [development reference](docs/DEVELOPMENT_REFERENCE.md) for runtime prerequisites. + +```sh +npm ci +node scripts/verify-repository-readiness.mjs +node --test scripts/verify-repository-readiness.test.mjs +npm run demo:fixtures:check +npm run demo:production:check +npm run demo:lint +npm run demo:typecheck +npm run demo:test +npm run demo:build +npm run demo:static:check +``` + +Use `npm run demo:e2e` with the pinned Playwright browser for affected user journeys. Inspect the relevant desktop/mobile views, themes and keyboard focus; a screenshot does not prove interaction behavior. The root `npm test` invokes the Python gateway and requires the research setup, including OPA. Do not substitute a mock or skip an established gate to hide a missing prerequisite. + +For substantial changes, state scope and meaningful acceptance checks, obtain independent review, and report implemented, locally checked, CI-verified and deployed states separately. Match tests to changed behavior; preserve failure evidence. Refresh source-bound evidence after relevant changes rather than reusing an earlier receipt. Merging, deployment and external changes must stay within the user's authorized scope. diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..a540d39 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,24 @@ +cff-version: 1.2.0 +message: "If you use APS in research or teaching, cite this repository and identify the commit or recorded evidence revision you used." +type: software +title: "Agentic Process Safety (APS)" +authors: + - name: "SafetyMP" + website: "https://github.com/SafetyMP" +repository-code: "https://github.com/SafetyMP/Agentic-Process-Safety" +url: "https://safetymp.github.io/Agentic-Process-Safety/" +license: Apache-2.0 +abstract: >- + An open-source research sandbox for investigating agent workflow hazards + through same-request control comparisons, case-specific causal paths, + recorded synthetic evidence and human reasoning. APS includes a static + guided investigation app and a separate HAZOP-inspired Python/OPA research + implementation. Illustrative outcomes and finite experiments do not + establish operational safety or the superiority of an analysis method. +keywords: + - agentic process safety + - multi-agent systems + - hazard analysis + - HAZOP + - agent governance + - human reasoning diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 43db27e..4a3f40a 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -2,6 +2,6 @@ This policy applies to project issues, pull requests, reviews and project-managed spaces. Respect participants across backgrounds, identities and experience levels. Provide constructive feedback, protect privacy and give credit. Harassment, discrimination, threats, sexualized attention, doxxing and disclosure of confidential information are unacceptable. -For a public incident without sensitive details, use GitHub report-content controls or request maintainer review of the thread. For private abuse reports use https://support.github.com/contact/report-abuse. This is a GitHub platform route, not a project-operated mailbox. No private project conduct contact or dedicated enforcement team is established; creating one remains an owner task before community launch. +For a public incident without sensitive details, use GitHub report-content controls or request maintainer review of the thread. For private abuse reports use https://support.github.com/contact/report-abuse. This is a GitHub platform route, not a project-operated mailbox. No private project conduct contact or dedicated enforcement team is established; establishing a project-operated channel remains an owner task. The private vulnerability-reporting channel in [SECURITY.md](SECURITY.md) is for security reports, not a substitute conduct or appeals process. Maintainers with actual permissions may remove harmful content, request corrections, restrict participation or refer abuse to GitHub, considering severity, recurrence and participant safety. Affected participants may request reconsideration through an available maintainer channel without publishing private evidence. No confidential project appeal channel, independent enforcement capacity or response SLA is claimed. Do not retaliate against good-faith reports. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f7261de..0e6d93f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,9 +1,43 @@ -# Contributing +# Contributing to APS -Start with [setup](README.md#setup-and-verification) and the [readiness audit](docs/open-source-readiness.md). This is a research sandbox with unverified hazards and no industrial safety approval. +APS helps people investigate when an agent's permitted action can still violate a workflow condition. Contributions should make the problem, comparison, causal explanation or human judgment clearer and better supported. Start with the [vision](docs/VISION.md), [user guide](docs/USER_GUIDE.md) and [documentation map](docs/README.md). The browser experience and Python/OPA research implementation have different contracts; identify which one your change affects. -Discuss substantial changes in a sanitized issue. Submit only work you have authority to license under [Apache-2.0](LICENSE); identify imported material and preserve third-party notices. No CLA or DCO process is established. Use [SECURITY.md](SECURITY.md) for vulnerabilities and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for conduct concerns. +Useful contributions include a confusing step with a reproducible example, a missing evidence relationship, a case-specific explanation, an accessibility improvement, or a test that exposes a real contract violation. Use the repository's bug, question or research/design proposal forms. A proposal should state the user or research question, what the current evidence supports, and what observation would demonstrate an improvement. -Use focused branches and PRs describing the problem, behavior and actual validation. Use the root lockfile and `npm ci`. Run `node scripts/verify-repository-readiness.mjs`, `npm test`, `npm run typecheck` and frontend checks from the README. Python/policy changes require `bash scripts/verify.sh`; Phase 3 changes require `bash scripts/verify-phase3.sh` and its prerequisites. Report failures and missing prerequisites explicitly. +## Development setup -Keep pinned deployment and verification gates intact. Never replace recorded evidence with simulation. Do not post secrets, operational data or confidential reference answers. Preserve pilot blinding/exposure boundaries: exposed contributors cannot claim blinded independent review. Human assignments, approvals, ratings and signoffs remain pending until actual human work. Review is required before merge; response times are not guaranteed. +For the static app, use Node.js 22.18+ and the single root lockfile: + +```sh +npm ci +npm run demo:dev +``` + +The app needs no Python, OPA, account, API key or backend. For research-engine and gateway changes, use the separate [research setup](docs/DEVELOPMENT_REFERENCE.md#research-commands). Python 3.11+ and OPA on `PATH` are needed for the root simulator tests. Do not confuse the browser's illustrative checks with execution of those research controls. + +## Make and verify a focused change + +Use a branch and explain the concrete problem and resulting behavior in a pull request. Match checks to the change: + +| Change | Validation | +| --- | --- | +| Documentation or community files | `node scripts/verify-repository-readiness.mjs` and `node --test scripts/verify-repository-readiness.test.mjs`; inspect links and commands | +| Browser app | `npm run demo:lint`, `npm run demo:typecheck`, `npm run demo:test`, `npm run demo:build`, `npm run demo:static:check` | +| Browser interaction or presentation | The browser checks above, then `npm run demo:e2e` with the pinned Playwright browser; inspect relevant desktop/mobile screenshots | +| Frozen data or research boundaries | `npm run demo:fixtures:check`, `npm run demo:fixtures:audit`, `npm run demo:production:check`; explain any missing raw originals | +| Research engine, simulator or policy | Research prerequisites, `npm test`, `npm run typecheck`, `bash scripts/verify.sh`; consult [Phase 3 operations](docs/PHASE3_OPERATIONS.md) before `bash scripts/verify-phase3.sh` | +| Release evidence or workflows | Existing predeployment/postdeployment rejection tests and the applicable source-bound verification procedure | + +See the [development reference](docs/DEVELOPMENT_REFERENCE.md#current-development-workflow) for browser installation. Report exact commands, failures and missing prerequisites. A passing local test is not a deployment receipt. UI changes should include safe visual evidence and checks of focus, keyboard use, responsive layouts and both themes where affected. Obtain independent review before merging substantial changes. + +## Preserve the evidence contract + +- Keep browser-model outcomes, frozen recorded trials, authored hazards and human discussion distinct. New free-text reasoning or a ready status must not grant operational authority. +- Preserve immutable comparisons, their request identities and their attached reasoning. Editing inputs must not relabel an earlier result. +- Keep source pins, production-boundary manifests and release checks intact. A changed protected file needs a separately reviewed scope decision; updating a hash to hide a failure is not a fix. +- Retain historical receipts as observations of their original revision. Do not rewrite them to imply fresh acceptance or publish generated private artifacts. +- Preserve pilot blinding and exposure records. A contributor who saw reference answers cannot claim an independent blinded review. Human approvals, ratings and assignments require actual human work. + +## Rights and participation + +Submit only work you have authority to contribute under [Apache-2.0](LICENSE); identify imported material and preserve third-party terms. No CLA or DCO process is established. Never include secrets, operational/private data or confidential reference answers. Use [SECURITY.md](SECURITY.md) for vulnerabilities and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for conduct concerns. Review and response times are not guaranteed. diff --git a/README.md b/README.md index bfd56e6..7c18fa6 100644 --- a/README.md +++ b/README.md @@ -1,113 +1,103 @@ -# Agentic Process Safety (APS): HAZOP for AI Agent Swarms +# Agentic Process Safety (APS) -Open-source research sandbox for **hazard and operability (HAZOP) analysis of AI agents and multi-agent systems**. APS combines deterministic hazard screening, a simulated procurement swarm, and policy-as-code experiments using **Open Policy Agent (OPA) and Rego**. +**Permission is only the first question.** APS is an open-source research and learning workspace for examining what must hold when an AI agent acts within a coordinated workflow: the right role, current approval, task-bound context, bounded delegation, and a defensible reason to proceed. -Compare the same illustrative request under different control bundles, follow the point where their outcomes diverge, and connect a proposed response to hazards and evidence. The separate research implementation models demand forecasting, inventory, supplier selection, finance approval and purchase execution. All tools are simulated; no real purchase or payment can be made. - -**SafetyMP research thesis — managing risk enables sustainable AI operations.** APS examines how delegation, shared context, and approval boundaries can introduce failure modes in multi-agent workflows. It links simulated hazards to proposed controls and repeatable experiments, asking whether risk can be managed without making agent collaboration impractical. These are research hypotheses, not proven production safeguards. See the [portfolio thesis](https://github.com/SafetyMP/SafetyMP). +[**Explore the live app**](https://safetymp.github.io/Agentic-Process-Safety/) · [Start the guided investigation](docs/USER_GUIDE.md) · [Project vision](docs/VISION.md) · [Documentation](docs/README.md) [![Repository checks](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/repository-checks.yml/badge.svg?branch=main)](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/repository-checks.yml) -[![Static demo workflow](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/deploy-pages.yml/badge.svg?branch=main)](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/deploy-pages.yml) +[![Pages deployment](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/deploy-pages.yml/badge.svg?branch=main)](https://github.com/SafetyMP/Agentic-Process-Safety/actions/workflows/deploy-pages.yml) [![License: Apache-2.0](https://img.shields.io/github/license/SafetyMP/Agentic-Process-Safety)](LICENSE) -[![Node 22.18+](https://img.shields.io/badge/node-%E2%89%A522.18-339933?logo=node.js&logoColor=white)](package.json) -[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](pyproject.toml) - -> **Scope:** Research sandbox. Hazards remain unverified, requirements proposed, ratings null and actual human approvals zero. APS provides no safety certification or production protection. - -**Jump to:** [Demo](#demo) · [Quick start](#quick-start) · [Architecture](#architecture) · [Verification](#verification) · [Security](#security) · [Documentation](#documentation-map) · [Contributing](CONTRIBUTING.md) - ---- -## What you can study +## The problem APS makes tangible -- **AI agent risk analysis:** trace tool use, delegation, shared context and approval hazards through the [HAZOP methodology](docs/METHODOLOGY.md). -- **Agent governance and policy enforcement:** inspect the Python gateway and OPA/Rego controls in the [governance architecture](docs/GOVERNANCE_ARCHITECTURE.md), separate from browser-only simulations. -- **Reproducible multi-agent experiments:** compare baseline, conventional access checks and HAZOP-informed checks with [Phase 3 experiments and assurance](docs/PHASE3_OPERATIONS.md). Finite sandbox results do not establish real-world safety. +A purchase worker has permission to use its tool and stays within budget. Finance approved the purchase, but its request reaches the execution boundary **61 logical seconds later**, after the modeled approval has expired. One control bundle permits the request; another holds it. The purchase is still outstanding. -## Demo +APS connects that concrete situation to the next human question: **what evidence or authority would justify a different action?** Compare the same request, inspect the causal path, change one condition, and form a position that preserves supporting evidence, uncertainty and disagreement. -The React/TypeScript explorer runs entirely in the browser, with no account, API key, paid inference, backend or telemetry. +The project applies hazard and operability (**HAZOP**) analysis to AI agents and multi-agent systems. Its procurement setting makes dependencies between demand, inventory, supplier selection, finance and purchase visible. It is useful for engineers examining agent controls, researchers inspecting the method and evidence, and reviewers discussing what remains unresolved. -The opening case asks: **the purchase agent has permission, but is its approval still valid?** An illustrative purchase arrives 61 logical seconds after finance approval; the modeled validity rule requires an age below 60. The amount is 300 sandbox units, a teaching input rather than a recovered historical trial amount. +## Try the experience -The five views support one connected investigation: +The [live app](https://safetymp.github.io/Agentic-Process-Safety/) needs no account, API key, paid inference, installation or backend. -- **Start here:** launch the approval-expiry case, browse all nine illustrative cases, and inspect the declared procurement topology. -- **Case Lab:** compare B (tool permission and spend limit) with C (additional lifecycle checks) against identical inputs; optionally include A (no modeled checks). Inspect decisions, a selectable failure path, and bounded illustrative effects. -- **Hazard study:** examine the selected case's intended behavior, deviations, assumptions and proposed controls, with the full 96-entry screening register, node × deviation matrix and 16 authored references available. -- **Controls:** inspect what a protection checks, where its authority comes from, and its implementation/test mapping. The Case Lab is the single browser request runner. -- **Evidence:** inspect the retained browser comparison separately from recorded experiments, paired B/C calls, replay, charts, source lineage and explicit gaps. +1. Open the approval case and **Run comparison**. B checks tool permission and spend; C adds lifecycle conditions. Both receive the same request and starting state. +2. Follow the decision path, then choose **Try 59 seconds** and run again. The original comparison remains available. C now permits the request because the approval is current. +3. Choose **Form a position**. A recommendation opens a relevant evidence request, review question or eligible hypothetical recovery. Attach the modeled check or a related recorded event, explain the rationale, and state what would change your mind. -Choose **Run comparison**, then vary approval age using 59/60/61 shortcuts or the age input. At 59 both B and C allow; at 60 and 61 B allows and C denies. Changing inputs creates a draft and does not relabel an earlier result. Retained comparisons preserve their inputs, predictions and reasoning across views. Normal and unauthorized-tool cases also show where B and C reach the same outcome. Six secondary cases retain rule exploration with business effects explicitly unmodeled. +Five connected views support that investigation: **Start here → Case Lab**, with **Hazard study**, **Controls** and **Evidence** available as supporting inspections. The [user guide](docs/USER_GUIDE.md) covers all nine cases, saved discussions, exports and the distinction between a new request and a retained result. -The **Discussion worksheet** attaches a recommendation, rationale, evidence, assumptions, unanswered question and dissent to a particular run. Marking a position ready grants no authority. **Explore a fresh-approval request** creates a hypothetical child from C's no-effect state with a new request identity; it preserves the denied parent and does not continue B's already executed purchase. A fresh approval still does not establish that a quotation, forecast or stock record is correct. +![APS compares the same request: B executes with expired approval, while C stops the request and leaves the purchase outstanding.](docs/assets/aps-comparison.jpg) -Use **Keep or export this discussion** for explicit browser-local save/load/delete, a readable Markdown brief, session JSON, and a configuration-only link. Notes remain in memory unless explicitly saved; loading a browser copy is an explicit action. Configuration links carry bounded inputs, not notes, outcomes or approvals. See the [redesign plan](docs/APS_EXPERIENCE_REDESIGN_PLAN.md) and [local implementation and verification record](docs/APS_REDESIGN_IMPLEMENTATION.md) for delivered scope and verification limits. +The guided experience was deployed on **2026-11-14** through [PR #32](https://github.com/SafetyMP/Agentic-Process-Safety/pull/32), at commit [`3ddc4ae`](https://github.com/SafetyMP/Agentic-Process-Safety/commit/3ddc4ae9a0dc42c5af98fa7818121cf18a1b364f). Its [deployment workflow](https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/43645203614) and 233-check browser run passed. This is a dated implementation result; badges and later runs describe subsequent revisions. -Keyboard entity buttons accompany the topology, the failure path has an ordered text representation, and charts include data tables. System, light and dark themes persist locally. The comparison explains these selected control bundles; it does not establish that HAZOP uniquely discovers the checks or outperforms other analysis methods. +## What the evidence means -The earlier executive journey, **Prepare example**, **Advance to next decision**, and decision-brief JSON import described in [continuity and saved brief usage](docs/CONTINUITY_IMPLEMENTATION.md) belong to a previous interface. That document is retained as historical implementation evidence, not instructions for this redesign. +| Material | What it supports | What it does not establish | +| --- | --- | --- | +| Illustrative browser comparison | How the fixed model's checks respond to the selected request | A live gateway decision, real purchase or complete business outcome | +| Frozen recorded experiments and replay | The retained synthetic trial's actual recorded calls and outcomes | That an edited browser request was executed in that trial | +| HAZOP findings and proposed controls | Questions, possible deviations and control mappings to investigate | Verified hazards, approved requirements or validated risk ratings | +| Human discussion | A recommendation, rationale, sources, uncertainty and dissent | Operational authorization or independent verification of the cited evidence | -**Project URL:** [safetymp.github.io/Agentic-Process-Safety](https://safetymp.github.io/Agentic-Process-Safety/). This README describes the redesign source; publication and source-bound CI acceptance for this revision require separate verification. The [earlier publication handoff](docs/STATIC_DEMO_PUBLICATION_HANDOFF.md) is retained as historical evidence and does not establish deployment of this redesign. +All hazards remain unverified, requirements proposed and risk ratings unset in the published fixtures. No real purchase or payment is made. The app does not establish production safety, safety certification, or that HAZOP outperforms another review method. Conventional systems can implement the same lifecycle checks. See the [vision and research questions](docs/VISION.md), [methodology](docs/METHODOLOGY.md) and [threat model](docs/THREAT_MODEL.md). -## Quick start +## Run locally -For the browser demo, install Node.js **22.18+** and npm. Run from the repository root using the single root lockfile: +For the browser app, use **Node.js 22.18+** and npm from the repository root. There is one root lockfile. -```bash +```sh git clone https://github.com/SafetyMP/Agentic-Process-Safety.git cd Agentic-Process-Safety npm ci npm run demo:dev ``` -Open the local URL printed by Vite at `/`. For a production build and local preview: +Open the local URL printed by Vite. To inspect the production build locally: -```bash +```sh npm run demo:build npm run demo:preview ``` -The browser demo is separate from the Python/OPA research implementation. It does not call OPA or authorize real operations. - -### Setup and verification - -The research engine and gateway also require **Python 3.11+** and **OPA 1.x** on `PATH`: +The separate research implementation requires **Python 3.11+** and **OPA 1.x** on `PATH`: -```bash +```sh python3 -m venv .venv .venv/bin/pip install -r requirements.lock npm ci -mkdir -p artifacts/phase2 -bash scripts/verify.sh > artifacts/phase2/full-verification.log 2>&1 +npm run demo ``` -Run `npm run demo` for the gateway-backed procurement simulation. Generated reports, CSV exports and verification logs stay in the ignored `artifacts/` directory. See the [development reference](docs/DEVELOPMENT_REFERENCE.md#setup-and-verification) for analysis CLI commands. +The browser app never calls this Python/OPA gateway. See [Phase 2 operations](docs/PHASE2_OPERATIONS.md) for setup and policy workflows, and [Phase 3 operations](docs/PHASE3_OPERATIONS.md) for experiments, offline dependencies and evidence inspection. -## Architecture +## Repository map -| Layer | Location | Responsibility | -| --- | --- | --- | -| HAZOP screening — Phase 1 | `packages/engine/`, `schemas/`, `examples/` | Deterministic findings, cascade paths, schema validation, review workflow and exports | -| Procurement swarm | `packages/simulator/` | TypeScript orchestrator and five simulated workers | -| Independent gateway — Phase 2 | `packages/governance/`, `policies/v1/` | OPA/Rego decisions, scoped identities, atomic transaction controls and signed authorization receipts | -| Experiments and assurance — Phase 3 | `packages/governance/`, `scripts/verify-phase3.sh` | Finite adversarial A/B/C experiments, telemetry, reports and source-bound execution attestation | -| Static explorer | `apps/aps-demo/` | Sanitized frozen snapshots and a separate illustrative TypeScript browser model | - -The explorer keeps **Recorded experimental results**, **Replayed test evidence** and **Illustrative browser simulation** distinct. Browser outcomes never replace frozen trial results. - -Read the [Phase 1 architecture](docs/ARCHITECTURE.md), [gateway architecture](docs/GOVERNANCE_ARCHITECTURE.md) and [methodology](docs/METHODOLOGY.md) for component and trust boundaries. +```mermaid +flowchart LR + H[HAZOP screening] --> F[Unverified findings and proposed controls] + G[Python and OPA research gateway] --> E[Recorded synthetic experiments] + F --> S[Frozen public snapshots] + E --> S + S --> U[Guided browser investigation] + M[Separate TypeScript illustration] --> U + U --> D[Human discussion and open questions] +``` -## Verification +| Location | Responsibility | +| --- | --- | +| [`apps/aps-demo/`](apps/aps-demo/) | React/TypeScript guided workspace; [browser model](apps/aps-demo/src/domain/README.md) and [fixture provenance](apps/aps-demo/src/fixtures/README.md) | +| [`packages/engine/`](packages/engine/) · [`schemas/`](schemas/) · [`examples/`](examples/) | Deterministic HAZOP screening, review contracts and authored examples | +| [`packages/simulator/`](packages/simulator/) | Procurement orchestrator and simulated workers | +| [`packages/governance/`](packages/governance/) · [`policies/v1/`](policies/v1/) | Research gateway, OPA/Rego controls, experiments and assurance tooling | +| [`tests/`](tests/) · [`scripts/`](scripts/) | Regression tests, integrity checks and evidence verification | +| [`docs/`](docs/README.md) | Current guides, technical references and clearly classified historical records | -Run the repository readiness check and frontend checks from the root: +## Verify a change -```bash +```sh node scripts/verify-repository-readiness.mjs -node --test scripts/verify-repository-readiness.test.mjs -npm run demo:fixtures:check -npm run demo:fixtures:audit npm run demo:production:check +npm run demo:fixtures:check npm run demo:lint npm run demo:typecheck npm run demo:test @@ -115,58 +105,12 @@ npm run demo:build npm run demo:static:check ``` -The fixture audit reports missing ignored originals explicitly and fails on differing available originals. For root simulator tests and types, complete the Python/OPA setup above, then run `npm test` and `npm run typecheck`. +Real-browser verification uses `npm run demo:e2e` with the pinned Playwright browser. Follow the browser setup in [Contributing](CONTRIBUTING.md) and the [development reference](docs/DEVELOPMENT_REFERENCE.md). Root `npm test` invokes the research gateway and needs the Python/OPA setup. Fresh acceptance must bind the exact source, workflow, artifact and reviewed screenshots; historical receipts cannot qualify new source. -Real-browser checks require the pinned Playwright browser. The runner defaults to Firefox on macOS and Chromium on Linux; unsupported values fail without fallback. See [browser setup](docs/DEVELOPMENT_REFERENCE.md#static-demonstration) for installation and `npm run demo:e2e`. +## Contribute and discuss -Phase 3 requires the pinned offline OpenTelemetry SDK before its complete assurance workflow: +Start with [Contributing](CONTRIBUTING.md), [Support](SUPPORT.md), the [Code of conduct](CODE_OF_CONDUCT.md), and [Security reporting](SECURITY.md). Useful contributions improve causal explanations, evidence mappings, reproducibility, accessibility and the quality of open questions. The [vision](docs/VISION.md) distinguishes current capability from research still needed. -```bash -.venv/bin/python -m pip install --no-index --find-links dependencies/otel-wheels --require-hashes -r dependencies/otel-wheels/requirements.lock -bash scripts/verify.sh -bash scripts/verify-otel-wheelhouse.sh -bash scripts/verify-phase3.sh -``` - -See [Phase 3 operations](docs/PHASE3_OPERATIONS.md) for fresh acceptance runs and evidence inspection. Historical logs and badges do not establish current browser acceptance, deployment success or human approval. - -## Security - -- Discussion notes and hypothetical fresh-approval branches affect local illustrative state only; they issue no operational authorization. The browser model omits authentication, real policy execution, atomic persistence, signed receipts and production objective arbitration. -- Local attestations, signing keys and ledger heads cannot independently establish identity or resist an owner replacing all local evidence. -- Finite experiment observations and unequal early-termination denominators are not real-world effectiveness estimates. Missing measurements remain unknown. -- Keep signing keys, databases and operational logs out of static deployments. Publish only reviewed public assets. -- Human review, risk acceptance and production decisions remain pending actual human work. - -Read the [threat model](docs/THREAT_MODEL.md), [security reporting policy](SECURITY.md) and [readiness audit](docs/open-source-readiness.md). Detailed experimental counts and evidence limitations remain in the [development reference](docs/DEVELOPMENT_REFERENCE.md#methodology-and-authenticity). - -## Community - -- [Contributing](CONTRIBUTING.md): setup, focused changes and required checks -- [Code of conduct](CODE_OF_CONDUCT.md): participation and enforcement expectations -- [Support](SUPPORT.md): questions and reproducible issue reports -- [Security](SECURITY.md): vulnerability reporting and supported scope +Coding agents should start with [AGENTS.md](AGENTS.md) for repository navigation and contribution constraints. Cite a specific revision using the [citation metadata](CITATION.cff); research results and interface revisions have different evidence boundaries. -Part of the [SafetyMP portfolio](https://github.com/SafetyMP). - -### Related projects - -- [FidusGate: MCP tool-call policy gateway](https://github.com/SafetyMP/FidusGate) explores policy decisions and signed receipts. -- [Corporate/Site Harness: evidence-gated software delivery](https://github.com/SafetyMP/corporate-site-harness) explores verification gates and human approval in agent-assisted development. - -## License - -Project-owned material is offered under [Apache 2.0](LICENSE), subject to preserved third-party terms and the pending source-data and rights review in the [readiness audit](docs/open-source-readiness.md). No release rights or industrial suitability are certified. - -## Documentation map - -| Topic | Start here | -| --- | --- | -| Analysis method and review gates | [Methodology](docs/METHODOLOGY.md) | -| Engine and gateway boundaries | [Phase 1 architecture](docs/ARCHITECTURE.md) · [Governance architecture](docs/GOVERNANCE_ARCHITECTURE.md) | -| Gateway operation and policy workflow | [Phase 2 operations](docs/PHASE2_OPERATIONS.md) | -| Experiments and attested assurance | [Phase 3 operations](docs/PHASE3_OPERATIONS.md) | -| Current browser redesign and local verification | [Redesign plan](docs/APS_EXPERIENCE_REDESIGN_PLAN.md) · [Implementation and verification](docs/APS_REDESIGN_IMPLEMENTATION.md) | -| Earlier browser QA and publication records (historical) | [Browser QA](docs/STATIC_DEMO_BROWSER_QA.md) · [Publication handoff](docs/STATIC_DEMO_PUBLICATION_HANDOFF.md) | -| Full CLI examples, human review syntax and retained evidence notes | [Development reference](docs/DEVELOPMENT_REFERENCE.md) | -| Open-source readiness and owner gates | [Readiness audit](docs/open-source-readiness.md) | +Part of the [SafetyMP portfolio](https://github.com/SafetyMP). Project-owned material is offered under [Apache-2.0](LICENSE), with third-party terms preserved. The [open-source readiness record](docs/open-source-readiness.md) documents remaining ownership and governance questions; a license is not certification of industrial suitability. diff --git a/SECURITY.md b/SECURITY.md index ef533e2..508da39 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -2,10 +2,16 @@ ## Supported versions -This pre-release prototype has no supported production release or LTS branch. The current development branch is the only candidate for best-effort investigation. Historical experiments, deployed snapshots and version 0.1.0 metadata are not maintenance commitments. No security response SLA is established. Do not use this sandbox as a production safety barrier. +APS is a research project with a public static investigation app and a separate local Python/OPA implementation. It has no supported production release or LTS branch. The current `main` branch is the candidate for best-effort investigation. Historical experiments, deployed snapshots and package-version metadata are not maintenance commitments. No security response SLA is established. Do not use this sandbox as a production safety barrier. + +## Scope and data + +The browser app makes illustrative comparisons; it does not call the Python gateway, authorize a purchase or submit discussion notes to a backend. Notes remain in memory unless a visitor explicitly saves a browser copy or downloads an export. An export may contain the visitor's free text; review it before sharing. The local research implementation has separate credentials, policy, persistence and receipt boundaries described in the [threat model](docs/THREAT_MODEL.md) and [governance architecture](docs/GOVERNANCE_ARCHITECTURE.md). + +Report incorrect security claims, unsafe static publication, exposed secrets, unintended network access, and violations of the declared gateway boundaries. An illustration's documented omission is not evidence that the omitted protection exists in production. ## Private reporting -Do not post vulnerability details, exploit payloads, keys or sensitive evidence in public issues or PRs. On the actual repository use Security → Advisories → Report a vulnerability **if enabled**. Enablement has not been verified here. No project security email or alternate confidential intake is verified. If the option is absent, a public issue may request only private reporting enablement, with no vulnerability details; retain the report privately until a confidential channel exists. +Do not post vulnerability details, exploit payloads, keys or sensitive evidence in public issues or PRs. Use GitHub's [private vulnerability report](https://github.com/SafetyMP/Agentic-Process-Safety/security/advisories/new), available under Security → Advisories → Report a vulnerability. Private vulnerability reporting was confirmed enabled through GitHub's authenticated API on 2026-11-14. This verifies the setting, not end-to-end intake, maintainer acknowledgment or a response SLA. No alternate confidential project intake is verified. If the option becomes unavailable, retain the report privately; a public issue may request only private-reporting enablement without vulnerability details. -In a private report include affected revision, environment, synthetic reproduction, impact and suggested mitigation. Never test live third-party services or purchasing systems. Maintainers should acknowledge privately, investigate, coordinate a fix/advisory and agree disclosure timing with the reporter. This is an intended process, not a staffed service. The owner must configure and test intake before public launch; see the [owner checklist](docs/open-source-readiness.md#pending-owner-checklist). +In a private report include affected revision, app or research component, environment, synthetic reproduction, impact and suggested mitigation. Never test live third-party services or purchasing systems. Maintainers should acknowledge privately, investigate, coordinate a fix/advisory and agree disclosure timing with the reporter. This is an intended process, not a staffed service. Testing confidential intake remains an owner task; see the [current owner decisions](docs/open-source-readiness.md#current-owner-decisions). diff --git a/SUPPORT.md b/SUPPORT.md index b53403b..c4d9a20 100644 --- a/SUPPORT.md +++ b/SUPPORT.md @@ -1,7 +1,18 @@ -# Support +# Getting help with APS -Start with the [README](README.md), [architecture](docs/ARCHITECTURE.md) and [readiness audit](docs/open-source-readiness.md) for setup, evidence limits and pending human review. See [CONTRIBUTING.md](CONTRIBUTING.md) for checks. +Try the [live app](https://safetymp.github.io/Agentic-Process-Safety/) and follow the [user guide](docs/USER_GUIDE.md) from comparison to a reasoned next step. The [vision](docs/VISION.md) explains the research question; the [documentation map](docs/README.md) separates current guidance from implementation references and historical records. For development, start with [Contributing](CONTRIBUTING.md). -On the actual repository, open a sanitized bug or question issue if Issues is enabled. Include revision, OS, Node/Python/OPA versions, commands, expected/actual behavior and a minimal synthetic reproduction. Remove secrets, personal information, operational data and confidential reference answers. Issue availability is unverified; there is no response SLA or commercial support commitment. Use [SECURITY.md](SECURITY.md) for vulnerabilities and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) for conduct concerns. +## Choose the right report -This project provides no industrial safety approval, risk acceptance or certification. Qualified humans must review evidence and authorize operational decisions outside this sandbox. +- **Bug:** a broken interaction, incorrect retained result, missing link or reproducible runtime failure. +- **Question:** using the app, understanding a case, running a command or interpreting an evidence boundary. +- **Research or design proposal:** a clearer investigation, a proposed case or control, a competing explanation, or evidence needed to assess a claim. +- **Vulnerability:** follow [Security](SECURITY.md) privately. Do not include vulnerability details in a public issue. + +Use the [issue chooser](https://github.com/SafetyMP/Agentic-Process-Safety/issues/new/choose). For an app report, include the route, selected case, input values, sequence of actions, browser/OS and viewport when relevant. State whether the observation concerns an illustrative comparison or a recorded trial. For a CLI report, include the commit, runtime versions, exact commands and a minimal synthetic reproduction. Remove secrets, personal information, operational data and confidential reference answers; review exported discussion notes before sharing them. + +## What support can establish + +Support can help explain modeled behavior and investigate defects. A discussion recommendation, successful test or sandbox trial does not establish that a real purchase should proceed, that a hazard has human approval, or that a system is safe. Operational decisions and risk acceptance remain outside this project. + +There is no response SLA or commercial support commitment. Use the [code of conduct](CODE_OF_CONDUCT.md) for participation concerns and the [current owner decisions](docs/open-source-readiness.md#current-owner-decisions) for unresolved maintenance and review responsibilities. diff --git a/apps/aps-demo/index.html b/apps/aps-demo/index.html index f1e81c4..f691cf5 100644 --- a/apps/aps-demo/index.html +++ b/apps/aps-demo/index.html @@ -4,51 +4,61 @@ - Agentic Process Safety | HAZOP for AI Agent Swarms - + Agentic Process Safety | Investigate AI Agent Workflow Risk + - - + + - - - + + + + + + + + + +
-

Agentic Process Safety: HAZOP for AI agent swarms

-

APS is an open-source research sandbox applying hazard and operability (HAZOP) analysis to multi-agent AI systems.

-

Explore hazards, controls and evidence

-

Follow five procurement workers and an orchestrator through demand forecasting, inventory, supplier selection, finance approval and simulated purchase execution.

-

The interactive explorer includes a HAZOP Lab, simulated policy decisions, a deterministic swarm simulator and recorded experimental evidence. The research implementation uses Python, TypeScript and OPA/Rego.

+

Agentic Process Safety: investigate AI agent workflow risk

+

Permission is only the beginning. An AI agent can have the right tool and stay within budget while relying on an approval, task context, or earlier decision that no longer applies.

+

APS is an open-source research sandbox for hazard and operability (HAZOP) analysis of coordinated AI agents. Compare the same request under different control bundles, follow the causal path, and form a human recommendation grounded in evidence.

+

Start with one purchase request

+

Finance approved a purchase, but the request arrives 61 logical seconds later. The model requires approval age below 60. Tool permission and spend checks permit it; an added freshness check stops it. Try 59 seconds, retain both results, and investigate what still needs to be known.

+

Compare, investigate, form a position

+

The Case Lab connects nine illustrative cases to a hazard study, proposed controls and frozen recorded evidence. Recommendations lead to case-specific evidence questions, policy-review questions, or an explicitly hypothetical recovery. Your notes do not issue approval or change the controls.

+

Read the project and evidence guide for a complete introduction without JavaScript, or use the interactive app when it loads. A plain-text source index is also available.

Research scope

-

Hazards remain unverified and controls proposed. Browser simulation is separate from recorded experimental results. No real purchases, safety certification or production protection are provided.

-

The interactive explorer requires JavaScript and runs entirely in your browser, without an account, API key, backend or telemetry.

+

Hazards remain unverified and controls proposed. The illustrative browser model, frozen experiment records and separate Python/OPA research implementation have different evidence boundaries. No real purchase, payment, safety certification or production protection is provided.

+

The interactive app runs entirely in your browser, without an account, API key, backend or telemetry. No live model inference occurs. Human learning and the value of the analysis method have not been established by these software checks.

diff --git a/apps/aps-demo/public/guide.html b/apps/aps-demo/public/guide.html new file mode 100644 index 0000000..06cb9eb --- /dev/null +++ b/apps/aps-demo/public/guide.html @@ -0,0 +1,88 @@ + + + + + + + APS Project Guide | Compare Controls, Trace Causes, Examine Evidence + + + + + + + + + + + + + + + + + + + + + + +
+
+

AGENTIC PROCESS SAFETY · PROJECT GUIDE

+

Permission is only the beginning.

+

An agent can have the right tool and stay within budget while acting on an approval or task context that no longer applies. APS makes that problem concrete, then asks what the people responsible should do next.

+

Agentic Process Safety is an open-source research sandbox applying hazard and operability (HAZOP) analysis to coordinated AI agent workflows. It connects intended behavior, possible deviations, proposed controls, evidence and human judgment. This guide works without JavaScript; the interactive app adds retained comparisons and a discussion worksheet.

+

A purchase request arrives too late

+

Demand, inventory and supplier workers contribute information. Finance supplies approval, purchase attempts the order, and an orchestrator coordinates the work. The final action depends on earlier conditions still holding.

+
The opening case: a purchase worker requests 300 sandbox units, 61 logical seconds after an assumed matching finance approval. The fixed browser rule requires approval age below 60 seconds. The browser does not contact finance or observe a real quotation.
+
+

B · Tool permission + spend limit

The worker has permission and the amount is within the ceiling. B permits the request. In this illustration, execution carries the expired approval condition into an order effect.

+

C · Lifecycle checks added

C also checks approval freshness and stops the request. No illustrative order is created under C. The purchase remains outstanding; a hold does not finish the task.

+
+

At 59 seconds both bundles permit the same request; at 60 and 61 seconds C stops it. Only approval age changes in the guided timing comparison. These are logical model values, not measured response times.

+

B is the particular tool-and-spend comparator used here. Conventional systems can implement freshness and task-binding checks too. The comparison does not show that HAZOP uniquely discovers those checks or outperforms another review method.

+
APS comparison: an expired-approval request executes under B and is stopped under C. Illustrative model only.
The interactive comparison keeps the same request visible in both lanes. These are illustrative effects, not a real order.
+

Use APS to form a position

+
    +
  1. Compare. Optionally predict the result, then run the same request through B and C from the same starting state. A, with no modeled checks, is available as an optional baseline.
  2. +
  3. Change or inspect. Try the other side of the expiry boundary and retain both results. For other cases, follow the specific condition through the decision path. A draft edit never relabels an earlier result.
  4. +
  5. Form a position. Choose a next action, explain its support and state what would change your mind. A current approval leads to questions about business inputs; other cases lead to their actual failed condition.
  6. +
+

Recommendations produce unresolved evidence requests, policy-review questions or, for the eligible denied expiry case, an explicitly hypothetical fresh-approval branch. Attach the selected modeled check or a related recorded event without replacing your notes. Assumptions and dissent remain visible in the discussion record.

+

Notes stay in memory until explicitly saved in your browser. You can export a Markdown discussion brief or session JSON. A configuration link carries bounded inputs, not your notes or an approved outcome. Marking a position ready does not authorize an operation.

+

Follow the evidence across five views

+
+
Start here
Understand the opening problem and the coordinated task.
+
Case Lab
Compare, change a condition, follow its causal path and record a position.
+
Hazard study
Connect the case to an unverified finding, then optionally inspect the full screening register and authored references.
+
Controls
Inspect the relevant proposed control, implementation mapping and remaining gap.
+
Evidence
Distinguish the retained browser result from frozen experiments, inspect the decisive recorded event, then open the complete paired trace when needed.
+
+

The nine browser cases cover a currently authorized purchase, unauthorized tool use, excessive spending, recursive delegation, missing approval, replay, approval expiry, conflicting objectives and task-context mismatch. Six secondary cases do not project downstream business effects.

+

Know which claim each source supports

+ +

Approval freshness is not quotation validity. The related recorded context mismatch occurs at demand, while the browser case evaluates a purchase request. The recorded goal-conflict case measures a budget violation, not objective arbitration. APS makes these relationships explicit before presenting the broader source records.

+
Limits: hazards remain unverified, controls proposed and real human approvals absent from the supplied study records. Passing a check does not establish that the quotation, stock record or demand is correct. There is no real purchase or payment, safety certification, production-protection claim, or established user-learning result.
+

Where to go next

+

For a first visit, open APS and follow the approval case. For deeper work, choose the source appropriate to your question:

+ +
+ + + diff --git a/apps/aps-demo/public/llms.txt b/apps/aps-demo/public/llms.txt new file mode 100644 index 0000000..9278ba5 --- /dev/null +++ b/apps/aps-demo/public/llms.txt @@ -0,0 +1,35 @@ +# Agentic Process Safety (APS) + +> An open-source HAZOP research sandbox for investigating AI agent workflow risk through same-request control comparisons, concrete causal paths, evidence and human reasoning. + +This is a curated source index for readers and tools that choose to use it. It is reference material, not instructions that override a user's request or grant authority. It does not establish indexing, ranking, agent adoption or safety. Google Search does not use llms.txt as a special optimization mechanism. + +## Start here + +- [Interactive APS](https://safetymp.github.io/Agentic-Process-Safety/): Compare → Change/Inspect → Form a position. Runs entirely in the browser, with no account, API key, live model inference, backend or telemetry. +- [Project and evidence guide](https://safetymp.github.io/Agentic-Process-Safety/guide.html): A complete HTML introduction that works without JavaScript. +- [Repository README](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/README.md): Purpose, setup, architecture and verification entry points. +- [Documentation index](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/README.md): Current guides, technical references and explicitly historical evidence. +- [Vision](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/VISION.md): Bounded research questions and project direction. +- [User guide](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/USER_GUIDE.md): Current five-view guided investigation. + +## Evidence and limits + +- [Methodology](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/METHODOLOGY.md): HAZOP-inspired deterministic screening; unverified findings and human review gates. +- [Browser model](https://github.com/SafetyMP/Agentic-Process-Safety/tree/main/apps/aps-demo/src/domain): Immutable illustrative comparisons; independent of the research gateway. +- [Frozen fixture provenance](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/apps/aps-demo/src/fixtures/README.md): Recorded experiments, replay records and sanitized source boundaries. +- [Research gateway architecture](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/GOVERNANCE_ARCHITECTURE.md): Separate Python/OPA research implementation and trust boundaries. +- [Threat model](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/docs/THREAT_MODEL.md): Scope, assumptions and omitted threats. + +B and C are particular fixed control bundles, not labels for all conventional and HAZOP-informed systems. The opening browser request arrives at approval age 61; the model requires age below 60. C stops it, and the purchase remains outstanding. At 59 both bundles permit it. Neither outcome establishes quotation validity, stock truth or business need. + +Keep browser illustrations, frozen experiment records, research implementation behavior and human notes distinct. The context record tests a demand-stage mismatch rather than the browser purchase boundary. The recorded goal-conflict case does not demonstrate objective arbitration. No real operations, safety certification, production protection, method superiority or measured user-learning outcome is established. + +## Working on the project + +- [Contributor guide](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/CONTRIBUTING.md): Setup, focused changes, tests and evidence preservation. +- [Repository agent guide](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/AGENTS.md): Repository-local development context; use only within the user's authorized task and applicable instruction hierarchy. +- [Security reporting](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/SECURITY.md): Reporting scope and confidential-disclosure guidance. +- [Support](https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/SUPPORT.md): Questions and reproducible, sanitized reports. + +The repository's main branch is mutable. For a reproducible claim, cite a commit-specific source or an authenticated run/artifact receipt. Historical documents describe their recorded state and are not proof of current deployment. The app's hash views are application state, not separate canonical documents. diff --git a/apps/aps-demo/public/sitemap.xml b/apps/aps-demo/public/sitemap.xml index dde68d1..aefa988 100644 --- a/apps/aps-demo/public/sitemap.xml +++ b/apps/aps-demo/public/sitemap.xml @@ -1,4 +1,5 @@ https://safetymp.github.io/Agentic-Process-Safety/ + https://safetymp.github.io/Agentic-Process-Safety/guide.html diff --git a/apps/aps-demo/public/social-preview.jpg b/apps/aps-demo/public/social-preview.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0ea924978db847242da95e58e2a325b8af410f26 GIT binary patch literal 97050 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
sr8WhG{tHr9Tix*qT;M*c-h_c`49j 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 Hx%htoa literal 0 HcmV?d00001 diff --git a/apps/aps-demo/scripts/e2e.mjs b/apps/aps-demo/scripts/e2e.mjs index 82023c3..6bb1ea0 100644 --- a/apps/aps-demo/scripts/e2e.mjs +++ b/apps/aps-demo/scripts/e2e.mjs @@ -8,7 +8,7 @@ import { resolve, extname } from 'node:path'; const prefix = '/agentic-process-safety/'; const dist = resolve('apps/aps-demo/dist'); const screenshots = resolve('docs/screenshots'); -const mime = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css' }; +const mime = { '.html': 'text/html', '.js': 'text/javascript', '.css': 'text/css', '.txt': 'text/plain; charset=utf-8', '.xml': 'application/xml', '.jpg': 'image/jpeg' }; const server = createServer(async (req, res) => { try { const pathname = decodeURIComponent(new URL(req.url, 'http://localhost').pathname); @@ -37,17 +37,21 @@ try { browser = await ({ chromium, firefox })[engine].launch({ headless: true }); console.log(`Browser engine running: ${engine} ${browser.version()}`); const context = await browser.newContext({ viewport: { width: 1440, height: 1000 }, reducedMotion: 'reduce' }); - await context.route('**/*', async route => { + const staticRequestsOnly = async route => { const request = route.request(); if (!request.url().startsWith(origin + prefix) || ['fetch', 'xhr', 'websocket', 'eventsource'].includes(request.resourceType())) { violations.push(`${request.resourceType()} ${request.url()}`); await route.abort(); } else await route.continue(); - }); + }; + await context.route('**/*', staticRequestsOnly); + const observePage = observed => { + observed.on('pageerror', error => errors.push(error.message)); + observed.on('console', message => { if (message.type() === 'error') errors.push(message.text()); }); + observed.on('websocket', socket => violations.push(socket.url())); + }; + context.on('page', observePage); const page = await context.newPage(); - page.on('pageerror', e => errors.push(e.message)); - page.on('console', m => { if (m.type() === 'error') errors.push(m.text()); }); - page.on('websocket', ws => violations.push(ws.url())); const go = async route => { await page.goto(`${origin}${prefix}#/${route}`); await expect(page.locator('h1')).toBeVisible(); assertions++; }; const check = async (assertion) => { await assertion(); assertions++; }; const currentComparison = () => page.getByRole('region', { name: 'Browser comparison', exact: true }); @@ -320,6 +324,51 @@ try { await check(() => expect(age).toHaveValue('59')); await page.getByRole('button', { name: 'Run comparison', exact: true }).focus(); await page.keyboard.press('Enter'); await check(() => expect(page.getByRole('heading', { name: 'Comparison results', exact: true })).toBeFocused()); + // Resource links open separately so inspecting a guide cannot destroy an unsaved investigation. + const retainedId = await page.getByLabel('Selected comparison', { exact: true }).inputValue(); + const unsavedRationale = 'Keep this unsaved position while I inspect the project resources.'; + await page.getByLabel('Reason for this recommendation', { exact: true }).fill(unsavedRationale); + const resources = page.getByRole('navigation', { name: 'Project resources', exact: true }); + await check(() => expect(resources.getByRole('link', { name: 'Source repository (opens in a new tab)', exact: true })).toHaveAttribute('href', 'https://github.com/SafetyMP/Agentic-Process-Safety')); + const guidePopupPromise = context.waitForEvent('page'); + await resources.getByRole('link', { name: 'Project guide (opens in a new tab)', exact: true }).click(); + const guidePopup = await guidePopupPromise; + await check(() => expect(guidePopup).toHaveURL(origin + prefix + 'guide.html')); + await check(() => expect(guidePopup).toHaveTitle('APS Project Guide | Compare Controls, Trace Causes, Examine Evidence')); + await check(() => expect(guidePopup.locator('link[rel="canonical"]')).toHaveAttribute('href', 'https://safetymp.github.io/Agentic-Process-Safety/guide.html')); + await check(() => expect(guidePopup.getByRole('heading', { level: 1 })).toHaveText('Permission is only the beginning.')); + await check(() => expect(guidePopup.getByLabel('Same-request control comparison', { exact: true })).toContainText('The purchase remains outstanding')); + await guidePopup.getByRole('link', { name: 'Open interactive APS', exact: true }).click(); + await check(() => expect(guidePopup).toHaveURL(origin + prefix + 'index.html')); + await check(() => expect(guidePopup.getByRole('navigation', { name: 'Main navigation', exact: true })).toBeVisible()); + await guidePopup.close(); + await check(() => expect(page.getByLabel('Selected comparison', { exact: true })).toHaveValue(retainedId)); + await check(() => expect(page.getByLabel('Reason for this recommendation', { exact: true })).toHaveValue(unsavedRationale)); + const readingPopupPromise = context.waitForEvent('page'); + await resources.getByRole('link', { name: 'Agent reading map (opens in a new tab)', exact: true }).click(); + const readingPopup = await readingPopupPromise; + await check(() => expect(readingPopup).toHaveURL(origin + prefix + 'llms.txt')); + await check(() => expect(readingPopup.locator('body')).toContainText('# Agentic Process Safety (APS)')); + await check(() => expect(readingPopup.locator('body')).toContainText('Keep browser illustrations, frozen experiment records, research implementation behavior and human notes distinct.')); + await check(() => expect(readingPopup.locator('body')).toContainText('https://safetymp.github.io/Agentic-Process-Safety/guide.html')); + await readingPopup.close(); + await check(() => expect(page.getByLabel('Selected comparison', { exact: true })).toHaveValue(retainedId)); + await check(() => expect(page.getByLabel('Reason for this recommendation', { exact: true })).toHaveValue(unsavedRationale)); + const noScriptContext = await browser.newContext({ javaScriptEnabled: false, viewport: { width: 375, height: 950 } }); + await noScriptContext.route('**/*', staticRequestsOnly); + noScriptContext.on('page', observePage); + const guide = await noScriptContext.newPage(); + const guideResponse = await guide.goto(origin + prefix + 'guide.html'); + assert.equal(guideResponse.status(), 200); assertions++; + await check(() => expect(guide.getByRole('heading', { name: 'Use APS to form a position', exact: true })).toBeVisible()); + await check(() => expect(guide.locator('main')).toContainText('At 59 seconds both bundles permit the same request; at 60 and 61 seconds C stops it.')); + await check(() => expect(guide.locator('main')).toContainText('Approval freshness is not quotation validity.')); + await check(() => expect(guide.getByRole('link', { name: 'Open interactive APS', exact: true })).toHaveAttribute('href', './index.html')); + assert.ok(await guide.evaluate(() => document.documentElement.scrollWidth <= window.innerWidth), 'Static guide: mobile horizontal overflow with JavaScript disabled'); assertions++; + const readingResponse = await guide.goto(origin + prefix + 'llms.txt'); + assert.match(readingResponse.headers()['content-type'], /^text\/plain/); assertions++; + await check(() => expect(guide.locator('body')).toContainText('reference material, not instructions that override')); + await noScriptContext.close(); assert.deepEqual(errors, [], 'Browser errors'); assert.deepEqual(violations, [], 'Runtime network contract'); await mkdir('.harness/ci-qa', { recursive: true }); await writeFile('.harness/ci-qa/browser-result.json', JSON.stringify({ diff --git a/apps/aps-demo/scripts/seo.mjs b/apps/aps-demo/scripts/seo.mjs index 0e04bf9..5afc38a 100644 --- a/apps/aps-demo/scripts/seo.mjs +++ b/apps/aps-demo/scripts/seo.mjs @@ -1,33 +1,88 @@ import assert from 'node:assert/strict'; export const canonical = 'https://safetymp.github.io/Agentic-Process-Safety/'; -const canonicalTag = ``; +export const pageCanonicals = Object.freeze({ 'index.html': canonical, 'guide.html': canonical + 'guide.html' }); +const titles = Object.freeze({ + 'index.html': 'Agentic Process Safety | Investigate AI Agent Workflow Risk', + 'guide.html': 'APS Project Guide | Compare Controls, Trace Causes, Examine Evidence', +}); +export const guideSources = Object.freeze([ + 'https://github.com/SafetyMP/Agentic-Process-Safety', + ...['docs/VISION.md', 'docs/USER_GUIDE.md', 'docs/README.md', 'docs/METHODOLOGY.md', 'CONTRIBUTING.md'].map(path => `https://github.com/SafetyMP/Agentic-Process-Safety/blob/main/${path}`), +]); -// Only this exact metadata tag is exempt from the no-remote-assets contract. -// Canonical metadata does not fetch a resource. Every other href stays checked. -export function withoutCanonical(html) { +// Closed page mapping: canonical metadata never loads a remote resource. +// Unknown pages and a correct URL attached to the wrong page are rejected. +export function withoutCanonical(html, page = 'index.html') { + assert.ok(Object.hasOwn(pageCanonicals, page), 'Unreviewed public document'); + const tag = ``; assert.equal((html.match(/]*\brel=["']canonical["'][^>]*>/gi) || []).length, 1, 'Expected one canonical link'); - assert.ok(html.slice(0, html.indexOf('')).includes(canonicalTag), 'Canonical must match the public project URL in head'); - return html.replace(canonicalTag, ''); + assert.ok(html.slice(0, html.indexOf('')).includes(tag), 'Canonical must match this public document in head'); + return html.replace(tag, ''); } -export function verifySeo(html, sitemap) { - withoutCanonical(html); - assert.match(html, /Agentic Process Safety \| HAZOP for AI Agent Swarms<\/title>/); +// Only literal, reviewed source-navigation anchors may leave the project. +// Extra attributes, other tags and unknown URLs remain visible to the strict +// static scanner. This cannot exempt a remote script, style, image or fetch. +export function withoutPublicNavigation(html, page = 'index.html') { + let text = withoutCanonical(html, page); + if (page === 'guide.html') { + for (const url of guideSources) text = text.replaceAll(`<a href="${url}">`, '<a>'); + } + return text; +} + +function verifyPage(html, page) { + withoutCanonical(html, page); + const title = titles[page]; + assert.ok(html.includes(`<title>${title}`), 'Missing current project title'); const description = html.match(/`), 'Inconsistent sharing description'); } - assert.ok(html.includes(``), 'Inconsistent Open Graph URL'); + for (const attribute of ['property="og:title"', 'name="twitter:title"']) { + assert.ok(html.includes(``), 'Inconsistent sharing title'); + } + assert.ok(html.includes(``), 'Inconsistent Open Graph URL'); assert.match(html, //); - assert.deepEqual([...sitemap.matchAll(/(.*?)<\/loc>/g)].map(m => m[1]), [canonical], 'Sitemap must contain only the canonical page, without hash routes'); + assert.match(html, //); + for (const attribute of ['property="og:image"', 'name="twitter:image"']) { + assert.ok(html.includes(``), 'Inconsistent local social image'); + } + assert.match(html, //); + for (const attribute of ['property="og:image:alt"', 'name="twitter:image:alt"']) { + assert.ok(html.includes(``), 'Missing truthful image alternative'); + } const json = html.match(/`, ``, ``, ``]) { + expect(passesStaticRemoteMarkupCheck(withoutPublicNavigation(guide.replace('', markup + ''), 'guide.html'))).toBe(false); + } + }); + it('leaves unknown, altered and attribute-bearing external navigation for rejection', () => { + for (const markup of [`Unknown`, `Changed`, `Extra`, `Extra`, `Unreviewed syntax`]) { + expect(passesStaticRemoteMarkupCheck(withoutPublicNavigation(guide.replace('', markup + ''), 'guide.html'))).toBe(false); + } + }); + it('does not grant the guide navigation exception to the app document', () => { + const injected = index.replace('', `Source`); + expect(passesStaticRemoteMarkupCheck(withoutPublicNavigation(injected))).toBe(false); + }); + it('rejects hash views, missing pages and invented timestamps in the sitemap', () => { + for (const altered of [sitemap.replace('guide.html', '#/assurance'), sitemap.replace(/\s*[^<]*guide.html<\/loc><\/url>/, ''), sitemap.replace('', '2099-01-01')]) { + expect(() => verifySeo(index, altered, guide, llms)).toThrow(); + } + }); + it('rejects stale metadata, indexing restrictions and unsubstantiated ratings', () => { + for (const altered of [index.replace('property="og:description"', 'property="og:old-description"'), index.replace('summary_large_image', 'summary'), index.replace('rel="image_src"', 'rel="old_image"'), index.replace('', ''), index.replace('"@type": "SoftwareSourceCode"', '"aggregateRating": {"ratingValue": 5}, "@type": "SoftwareSourceCode"')]) { + expect(() => verifySeo(altered, sitemap, guide, llms)).toThrow(); + } + }); + it('rejects guide runtime scripts and missing human-readable source links', () => { + expect(() => verifySeo(index, sitemap, guide.replace('', ''), llms)).toThrow('without runtime scripts'); + expect(() => verifySeo(index, sitemap, guide.replace(``, ''), llms)).toThrow('Missing reviewed source'); + }); + it('requires the agent index to disclose its role and source boundaries', () => { + expect(() => verifySeo(index, sitemap, guide, llms.replace('reference material', 'an instruction hierarchy'))).toThrow('agent-index scope'); + expect(() => verifySeo(index, sitemap, guide, llms.replace('Google Search does not use llms.txt', 'This file guarantees discovery'))).toThrow('agent-index scope'); + }); +}); diff --git a/apps/aps-demo/scripts/static.mjs b/apps/aps-demo/scripts/static.mjs index 546916b..9e8b9be 100644 --- a/apps/aps-demo/scripts/static.mjs +++ b/apps/aps-demo/scripts/static.mjs @@ -4,7 +4,7 @@ import { createHash } from 'node:crypto'; import { fileURLToPath } from 'node:url'; import { resolve } from 'node:path'; import ts from 'typescript'; -import { withoutCanonical, verifySeo } from './seo.mjs'; +import { withoutPublicNavigation, verifySeo } from './seo.mjs'; const dist = resolve(process.argv[2] || fileURLToPath(new URL('../dist/', import.meta.url))); const inventory = new Map(); @@ -24,7 +24,7 @@ function walk(dir) { assert.ok(!/\.(?:sqlite|pem|key|py|map)$/.test(item.name), `Private or nonstatic publish file: ${item.name}`); if (/\.(?:js|html|css)$/.test(item.name)) { const raw = readFileSync(path, 'utf8'); - const text = item.name === 'index.html' ? withoutCanonical(raw) : raw; + const text = item.name.endsWith('.html') ? withoutPublicNavigation(raw, path.slice(dist.length + 1)) : raw; assert.ok(!/(?:BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY|sk-proj-[A-Za-z0-9]{15}|ghp_[A-Za-z0-9]{20})/.test(text), 'Credential material in publish asset'); // Libraries may include documentation links and SVG namespaces; forbid executable network primitives and remote asset markup. assert.ok(!/\b(?:fetch\s*\(|new\s+(?:WebSocket|EventSource|XMLHttpRequest)\s*\(|navigator\.sendBeacon\s*\()/m.test(text), `Runtime networking found: ${item.name}`); @@ -38,7 +38,7 @@ assert.ok(files < 10000 && bytes < 128 * 1024 * 1024, 'Publish capacity exceeded const html = readFileSync(resolve(dist, 'index.html'), 'utf8'); assert.match(html, /]*src="[^" ]+\.js"/); assert.ok(!/ m[1]); + references = [...withoutPublicNavigation(text, name).matchAll(/(?:src|href)=["']([^"']+)["']/g)].map(m => m[1]); } else if (name.endsWith('.js')) { // Parse syntax so documentation strings containing import examples cannot // masquerade as executable module edges. diff --git a/apps/aps-demo/scripts/validation-evidence.mjs b/apps/aps-demo/scripts/validation-evidence.mjs index 64dc670..383b8a5 100644 --- a/apps/aps-demo/scripts/validation-evidence.mjs +++ b/apps/aps-demo/scripts/validation-evidence.mjs @@ -9,7 +9,7 @@ import { createRequire } from 'node:module'; const require = createRequire(import.meta.url); const repository = 'safetymp/agentic-process-safety'; const workflow = '.github/workflows/repository-checks.yml'; -const releaseHeadRefs = Object.freeze(['release/aps-github-validation-v1', 'codex/aps-redesign-release', 'codex/aps-guided-investigation']); +const releaseHeadRefs = Object.freeze(['release/aps-github-validation-v1', 'codex/aps-redesign-release', 'codex/aps-guided-investigation', 'codex/aps-repository-alignment']); const destination = '.harness/ci-qa/validation.json'; const hash = bytes => createHash('sha256').update(bytes).digest('hex'); const blob = bytes => createHash('sha1').update(`blob ${bytes.length}\0`).update(bytes).digest('hex'); diff --git a/apps/aps-demo/src/App.tsx b/apps/aps-demo/src/App.tsx index db45e17..6b39e51 100644 --- a/apps/aps-demo/src/App.tsx +++ b/apps/aps-demo/src/App.tsx @@ -45,10 +45,10 @@ function Workspace() { return () => media.removeEventListener('change', apply); }, [theme]); useEffect(() => { - document.title = `${currentSection.name} | Agentic Process Safety`; + document.title = location.route === 'overview' ? 'Agentic Process Safety | Investigate AI Agent Workflow Risk' : `${currentSection.name} | Agentic Process Safety`; document.documentElement.scrollIntoView?.({ block: 'start' }); document.getElementById('main-content')?.focus({ preventScroll: true }); - }, [currentSection.name]); + }, [currentSection.name, location.route]); useEffect(() => { if (location.route === 'simulator' && location.params.get('panel') === 'discussion') { document.getElementById('discussion')?.scrollIntoView?.({ block: 'start' }); @@ -78,7 +78,7 @@ function Workspace() { {configError &&
{configError}
} {location.route === 'overview' ? : location.route === 'hazop' ? : location.route === 'governance' ? : location.route === 'simulator' ? : } -
APS Research DemonstrationAll hazards unverified · Browser effects illustrative · No safety certification
+
; } diff --git a/apps/aps-demo/src/domain/README.md b/apps/aps-demo/src/domain/README.md index e46ea5c..375e41e 100644 --- a/apps/aps-demo/src/domain/README.md +++ b/apps/aps-demo/src/domain/README.md @@ -1,9 +1,35 @@ -# Illustrative browser model +# Browser comparison and investigation model -`simulation.ts` is a pure reducer: scheduling a timer does not supply time to policy decisions. The view must dispatch `timer` on each interval and clear its interval on pause/unmount. A paused timer action cannot advance state. `step` advances one logical stage; stage three evaluates a simulated purchase. Review suspends progression until an explicit approve/deny action. Reset and configuration clear prior events and injected faults. +This directory implements the illustrative domain used by the current APS Case Lab. Start with the [project vision](../../../../docs/VISION.md), [user guide](../../../../docs/USER_GUIDE.md) and [architecture](../../../../docs/ARCHITECTURE.md). It is a separate TypeScript model; it does not invoke the Python/OPA gateway or mutate frozen research results. -Seeds are integers from 0 to 2147483647 (invalid input defaults to 1). Integer mixing selects a benign amount from 100–399; this is an intentionally different deterministic generator from the Python research workload. No browser run is a replay or a recorded research trial. Event IDs have a `sim-` prefix and never assert receipt authenticity. +## Current modules -A has no checks. B checks actor/tool scope and spend. C additionally illustrates depth, approval, replay, expiry and context checks. Conflict review is an **illustrative addition**, linked to `GAP-CONFLICTING_OBJECTIVES`; there is no production objective arbitration control or test. UI links should resolve story control IDs through frozen requirements to their hazard IDs and source test selectors, showing gaps explicitly. Passing browser tests does not execute those production tests. +| Module | Contract | +| --- | --- | +| `scenarios.ts` | Defines the nine case presets and the selected A/B/C control bundles. | +| `cases.ts` | Resolves case descriptions, source relationships and bounded drafts; validates the editable approval-age input. | +| `simulation.ts` | Supplies pure request evaluation and ordered check traces used by comparisons; also retains the older timer-based reducer described below. | +| `comparison.ts` | Creates immutable, versioned request snapshots and independent lane outcomes from an equal baseline; separates constraint violations from execution status and bounded illustrative effects. | +| `session.ts` | Owns draft/run selection, retained predictions and run-bound discussion, explicit hypothetical recovery, bounded configuration links, saved-session validation and exports. | +| `presentation.ts` | Derives truthful run titles, constraint meaning and case-specific causal stages from retained inputs and outcomes. | -All decisions and metrics are illustrative, not authoritative enforcement. The model performs no network activity, procurement, cryptographic signing, authentication or backend calls. Frozen experimental metrics must be rendered from fixtures independently of this state. +`components/SessionContext.tsx` is the shared route-level state owner. The current interaction is **Compare → Change/Inspect → Form a position**. No browser timer ages an evaluated request. An input edit creates a dirty draft; it does not relabel the selected result. Only an explicit comparison evaluates the new input. + +## Comparison and reasoning invariants + +- Every lane receives the same retained request and baseline. A has no modeled checks; B checks actor/tool scope and spend; C adds defined workflow conditions. These are selected bundles, not a claim that conventional systems cannot implement expiry or task binding. +- Approval age is a logical input. C's fixed freshness rule is `approvalAge < 60`; ages 60 and 61 fail, while 59 passes when the other preset conditions hold. The comparison does not measure wall-clock latency. +- Illustrative order/spend effects are exposed only for supported purchase cases; secondary cases explicitly leave business effects unmodeled. A passed check does not establish quotation, stock or demand truth. +- Retained comparisons keep their input, request identity, prediction and discussion. Ordinary reruns use an equal starting state; they do not accumulate orders from previous results. +- An eligible fresh-approval exploration creates a new hypothetical request from the denied parent's C no-effect state. The parent remains unchanged. This is not a continuation of B's executed purchase or a recorded recovery demonstration. +- Recommendations choose an investigation, review question or eligible hypothetical exploration. Their text, evidence attachments and discussion-ready status never grant tool authority, approve a hazard or change a policy. +- Evidence notes identify the selected modeled check or related recorded event. Appending an attachment preserves authored text and distinguishes its source; a recorded case may differ from the browser illustration. +- Save/load/delete are explicit browser-local actions. Configuration links carry bounded inputs only; Markdown and session JSON exports include free-text discussion. No account, network request or telemetry is involved. + +The session envelope uses schema version 1 and model `aps-case-comparison-v1`. Parsing validates saved inputs, identities, parent links and discussion references, and reconstructs modeled outcomes rather than trusting arbitrary saved result claims. Keep model/session changes explicit and review compatibility before changing these contracts. + +## Retained legacy simulation reducer + +The timer-based `simulation.ts` reducer and its tests remain available as a legacy module, not the current Case Lab's user flow. In that reducer a dispatched `timer` action advances logical state only while running; `step` advances a stage; review suspends progression; reset/configuration clear prior events and injected faults. Seeds use a deterministic benign amount generator distinct from the Python research workload, and `sim-` event IDs carry no receipt authenticity. Do not describe its Start/Pause/Step controls or approve/deny actions as current guided-app features. + +All browser decisions and effects are illustrative. The module performs no procurement, cryptographic signing, authentication or backend calls. Recorded experiment metrics come only from the separate [frozen fixtures](../fixtures/README.md). Tests establish bounded implementation behavior, not operational safety or the quality of a user's reasoning. diff --git a/apps/aps-demo/src/styles.css b/apps/aps-demo/src/styles.css index 2702328..d854525 100644 --- a/apps/aps-demo/src/styles.css +++ b/apps/aps-demo/src/styles.css @@ -242,6 +242,7 @@ main:focus { outline:none; } } /* Guided investigation: progress follows the retained run, not a score. */ +footer nav { display:flex; flex-wrap:wrap; gap:12px; margin-top:8px; font-size:12px; } .case-progress { display:block; margin:0 0 24px; } .case-progress-list { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)); gap:10px; list-style:none; padding:0; margin:0; } .case-progress-list li { min-width:0; margin:0; } diff --git a/apps/aps-demo/src/views.test.tsx b/apps/aps-demo/src/views.test.tsx index 3e445d2..f74bb7f 100644 --- a/apps/aps-demo/src/views.test.tsx +++ b/apps/aps-demo/src/views.test.tsx @@ -217,6 +217,20 @@ describe('paired case investigation', () => { }); describe('full-app context and evidence', () => { + it('offers a static project guide, agent reading map and repository from every app view', async () => { + render(); + for (const route of ['overview', 'hazop', 'governance', 'simulator', 'assurance']) { + await navigate(`#/${route}`); + const resources = screen.getByRole('navigation', { name: 'Project resources' }); + for (const link of within(resources).getAllByRole('link')) { + expect(link.getAttribute('target')).toBe('_blank'); + expect(link.getAttribute('rel')).toMatch(/(?:^|\s)noopener(?:$|\s)/); + } + expect(within(resources).getByRole('link', { name: 'Project guide (opens in a new tab)' }).getAttribute('href')).toBe('./guide.html'); + expect(within(resources).getByRole('link', { name: 'Agent reading map (opens in a new tab)' }).getAttribute('href')).toBe('./llms.txt'); + expect(within(resources).getByRole('link', { name: 'Source repository (opens in a new tab)' }).getAttribute('href')).toBe('https://github.com/SafetyMP/Agentic-Process-Safety'); + } + }); it('preserves comparison and exact labels for populated reasoning across supporting views', async () => { window.location.hash = '#/simulator'; render(); const prediction = 'Only the lifecycle checks inspect approval freshness.'; diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 275b067..7d2d196 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -1,4 +1,21 @@ -# Phase 1 repository inspection and architecture +# APS architecture and retained Phase 1 baseline + +## Current project layers + +The current APS experience connects one request, a comparison of control bundles, a causal explanation, related source evidence and a human position. The browser demonstration and the research runtime have separate state and authority. See the [vision](VISION.md), [user guide](USER_GUIDE.md) and [documentation map](README.md). + +| Layer | Entry point | Boundary | +| --- | --- | --- | +| Guided browser investigation | `apps/aps-demo/src/routes/`, `components/SessionContext.tsx` | Five views share retained illustrative comparisons and local reasoning; no backend calls. | +| Browser comparison model | [Domain guide](../apps/aps-demo/src/domain/README.md) | Fixed A/B/C checks, explicit input snapshots, hypothetical effects and recovery; not recorded experiment execution. | +| Frozen evidence | `apps/aps-demo/src/fixtures/` | Reviewed snapshots with hashes, source relationships and explicit gaps; browser choices cannot alter trials. | +| HAZOP screening | `packages/engine/` | Proposed findings and review contracts described below. | +| Gateway-backed research | [Governance architecture](GOVERNANCE_ARCHITECTURE.md) | Python/OPA authorization, simulated adapters and local evidence; not invoked by the public app. | +| Experiments and assurance | [Phase 3 operations](PHASE3_OPERATIONS.md) | Finite workload measurements and source-bound execution records, separate from user-learning validation. | + +The current browser path is **Compare → Change/Inspect → Form a position**. An edited draft never relabels a retained result. Evidence attachments distinguish a modeled check from a recorded event; a recommendation does not grant execution authority. The [development reference](DEVELOPMENT_REFERENCE.md#current-development-workflow) provides setup and checks. + +## Retained Phase 1 inspection This document retains the Phase 1 baseline. Current execution uses the [Phase 2 gateway](GOVERNANCE_ARCHITECTURE.md); Phase 1 analysis contracts remain unchanged. diff --git a/docs/DEVELOPMENT_REFERENCE.md b/docs/DEVELOPMENT_REFERENCE.md index 8a20618..e875f54 100644 --- a/docs/DEVELOPMENT_REFERENCE.md +++ b/docs/DEVELOPMENT_REFERENCE.md @@ -1,5 +1,77 @@ # Development reference +APS has two deliberately separate execution paths: the **guided browser investigation** and the **Python/OPA research implementation**. Start with the [vision](VISION.md), [user guide](USER_GUIDE.md) or [documentation map](README.md) when you need project context. This page gives current development entry points and preserves the earlier implementation notes below. + +## Current development workflow + +Use Node.js 22.18+ and the single root npm lockfile. From the repository root: + +```sh +npm ci +npm run demo:dev +``` + +Open the Vite URL printed by the command at `/`. The current browser experience follows **Compare → Change/Inspect → Form a position**. It evaluates an explicit request under fixed control bundles, retains prior comparisons, shows case-specific causal stages and attaches local human reasoning. It does not use the historical Start/Pause/Step flow described in the archived notes below. + +The frontend is in `apps/aps-demo/`; [the browser domain guide](../apps/aps-demo/src/domain/README.md) identifies the case, comparison, session and presentation contracts. React routes share one session through `SessionContext.tsx`. The browser never calls the Python gateway, OPA or a live procurement service. + +Run the checks appropriate to frontend changes: + +```sh +node scripts/verify-repository-readiness.mjs +node --test scripts/verify-repository-readiness.test.mjs +npm run demo:fixtures:check +npm run demo:production:check +npm run demo:lint +npm run demo:typecheck +npm run demo:test +npm run demo:build +npm run demo:static:check +``` + +For local built-site verification, install the browser version pinned by the root lockfile and explicitly choose the same engine when running it: + +```sh +mkdir -p .harness/tmp +PLAYWRIGHT_BROWSERS_PATH=.harness/playwright TMPDIR="$PWD/.harness/tmp" npx playwright install chromium --only-shell +APS_BROWSER=chromium PLAYWRIGHT_BROWSERS_PATH=.harness/playwright npm run demo:e2e +``` + +The runner also supports Firefox and defaults to Firefox on macOS when `APS_BROWSER` is absent; it defaults to Chromium on Linux. Browser installation and launch may need host permissions. A local browser result is distinct from the hosted Linux deployment evidence. Run `npm run demo:preview` to inspect a production build locally at the printed origin. + +## Research commands + +The gateway-backed simulator requires Python 3.11+, OPA 1.x on `PATH`, and the locked Python dependencies: + +```sh +python3 -m venv .venv +.venv/bin/pip install -r requirements.lock +npm ci +npm test +npm run typecheck +npm run demo +``` + +Use [Phase 2 operations](PHASE2_OPERATIONS.md) for policy and gateway commands, [Phase 3 operations](PHASE3_OPERATIONS.md) for finite experiments and attested assurance, and [methodology](METHODOLOGY.md) for human review boundaries. These are research workflows, separate from the browser's illustrative comparisons. Full `scripts/verify.sh` and Phase 3 commands include broader research work; inspect their scope before running them for a documentation or presentation-only change. + +## Release and evidence maintenance + +The guided experience was deployed from [PR #32](https://github.com/SafetyMP/Agentic-Process-Safety/pull/32), commit `3ddc4ae9a0dc42c5af98fa7818121cf18a1b364f`, on 2026-11-14. [Deployment run 43645203614](https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/43645203614) passed. That release passed 233 built-site and 233 live-site browser checks; all nine published files matched its authenticated artifact. This is a dated release observation, not acceptance of subsequent source changes. + +[The Pages workflow](../.github/workflows/deploy-pages.yml) builds, checks and deploys only `apps/aps-demo/dist`. Source-bound evidence identifies the commit, workflow, run, artifact and reviewed screenshots. Changes to source or discovery assets require fresh evidence; changing a prior receipt does not validate a new release. Preserve historical ZIPs, review records, original fixtures and production-integrity pins. + +- `npm run demo:fixtures:audit` checks available local originals and explicitly reports missing ignored sources; clean CI uses the committed snapshot contract. +- `scripts/verify-linux-predeploy-evidence.mjs` verifies a reviewed PR artifact without attesting deployment. +- `scripts/verify-linux-ci-evidence.mjs` verifies the hosted Linux deployment receipt against exact source/build evidence and authenticated metadata. +- See [search visibility](SEO.md) for canonical URLs, static discovery assets and external indexing limits. + +## Historical development notes + +The following snapshot is preserved for provenance. Its old interface controls, publication blockers, release counts and proposed-tree statements describe their original revisions. Use the current workflow above and the linked operations references for new work; a historical missing capability or failed gate is not a claim about today's deployment. + +
+Read the retained README and development snapshot + This document preserves the detailed README notes from the main-branch snapshot used for the README restructuring. Publication status, run identities and validation observations below are retained historical notes, not fresh verification. Start with the [project README](../README.md) for onboarding. ## Research implementation and retained notes @@ -134,3 +206,6 @@ AI-generated findings remain marked as such even after review. Approval requires ### Readiness revision evidence limit This PR adds community documentation and npm license metadata. The retained Linux browser evidence is bound to the earlier source manifest; metadata changes make it stale. No current browser acceptance, CI success, deployment or human approval is claimed. See the [readiness audit](../docs/open-source-readiness.md) for validation and owner gates. + + +
diff --git a/docs/GOVERNANCE_ARCHITECTURE.md b/docs/GOVERNANCE_ARCHITECTURE.md index 89623b8..ffa71f9 100644 --- a/docs/GOVERNANCE_ARCHITECTURE.md +++ b/docs/GOVERNANCE_ARCHITECTURE.md @@ -1,4 +1,8 @@ -# Phase 2 authorization architecture +# Research gateway architecture + +The Python/OPA gateway described here is a separate research implementation. The public APS app illustrates selected request checks in TypeScript; it does not invoke this gateway, issue signed grants or execute real procurement. Its recommendation-driven investigation and local discussion notes have no operational authority. Start with the [project architecture](ARCHITECTURE.md), [user guide](USER_GUIDE.md) or [development reference](DEVELOPMENT_REFERENCE.md) to choose the appropriate runtime. + +The following Phase 2 architecture remains the gateway contract. Phase 3 adds finite experiments and assurance around it; see [Phase 3 operations](PHASE3_OPERATIONS.md). Original environment/version observations below retain their implementation-time meaning; current CI dependencies are pinned in the workflows and lockfiles. ## Decision and repository boundaries diff --git a/docs/METHODOLOGY.md b/docs/METHODOLOGY.md index 5b6ef00..026bbc8 100644 --- a/docs/METHODOLOGY.md +++ b/docs/METHODOLOGY.md @@ -1,4 +1,14 @@ -# Phase 1 methodology +# APS methodology and retained screening procedure + +## How the current investigation uses HAZOP + +APS asks which conditions must still hold when an agent acts within a coordinated workflow. Its guided experience makes a specific request and its assumptions visible, compares selected control bundles, follows the causal condition, and asks the user to form a supported next step. The [vision](VISION.md) frames the research questions; the [user guide](USER_GUIDE.md) explains the interaction. + +The screening procedure below is one source of candidate hazards and controls. Browser comparisons illustrate defined checks; they do not establish that HAZOP uniquely discovers those checks or improves hazard quality compared with another method. The recorded experiments are finite synthetic observations. Neither those observations nor browser test passes establish participant comprehension, operational control effectiveness or human risk acceptance. + +A discussion position preserves a recommendation, rationale, supporting observations, unknowns and dissent for a retained run. Marking it ready means ready for discussion, not approved. A source hazard, browser request and recorded trial may be related without describing the same event: approval freshness does not prove quotation validity; task binding does not prove information truth; a recorded budget violation does not resolve competing objectives. + +## Retained Phase 1 screening procedure This is an auditable HAZOP-inspired screening engine for agent workflows. The general guideword study structure is informed by the public description of [IEC 61882:2016](https://webstore.iec.ch/en/publication/24321), which covers study preparation, examination, documentation and follow-up. Only the public description was consulted; this implementation has not been assessed against the full standard. The six agent-specific deviations are project extensions, not claims about IEC guidewords. No certification or completeness claim is made. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..029ed61 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,109 @@ +# APS documentation map + +[Project overview](../README.md) · [Live app](https://safetymp.github.io/Agentic-Process-Safety/) · [User guide](USER_GUIDE.md) · [Vision](VISION.md) + +APS now centers on a guided investigation: compare the same request, inspect or change a condition, and form an evidence-linked position. The browser experience and the Python/OPA research implementation are separate layers. Use the current guides below for navigation; use historical records to understand what a particular work unit actually established. + +**Status key:** **Current guide** describes how to use or contribute to the present project. **Technical reference** describes a retained implementation contract or research method; results still need source-bound verification. **Historical record** preserves a dated plan, checkpoint or acceptance boundary and does not establish the current release state. **Integrity contract** is an active machine-readable preservation boundary, not a document to refresh by rewriting its evidence. + +## Start by intent + +| Intent | Start here | Status | +| --- | --- | --- | +| Understand the project and run it locally | [Project README](../README.md) | Current guide | +| Explore the app and its nine cases | [User guide](USER_GUIDE.md) | Current guide | +| Understand the problem, scope and unanswered research questions | [Vision](VISION.md) | Current guide | +| Navigate all documentation | [Documentation map](README.md) | Current guide | +| Develop or verify a change | [Development reference](DEVELOPMENT_REFERENCE.md) | Current workflow with separately retained historical notes | +| Contribute, report a bug or request help | [Contributing](../CONTRIBUTING.md) · [Support](../SUPPORT.md) · [PR template](../.github/PULL_REQUEST_TEMPLATE.md) | Current guides | +| Use a coding agent or cite the project | [Agent guide](../AGENTS.md) · [Citation metadata](../CITATION.cff) | Current repository metadata | +| Understand community and security expectations | [Code of conduct](../CODE_OF_CONDUCT.md) · [Security reporting](../SECURITY.md) | Current policies | +| Inspect publication and repository governance | [Open-source readiness](open-source-readiness.md) | Current guidance and dated observations; see its explicit limits | +| Inspect search and agent discovery | [Search visibility](SEO.md) | Current guide | + +## Research and implementation references + +These describe mechanisms and assumptions, not a replacement for the current app guide. The Phase 1/2/3 names identify research implementation layers. + +| Topic | Document | Status | +| --- | --- | --- | +| Browser comparison, session and evidence contracts | [Browser domain](../apps/aps-demo/src/domain/README.md) | Technical reference | +| Frozen public data and source provenance | [Fixture documentation](../apps/aps-demo/src/fixtures/README.md) | Technical reference | +| HAZOP-inspired screening and human review | [Methodology](METHODOLOGY.md) | Technical reference | +| Engine layout and Phase 1 baseline | [Architecture](ARCHITECTURE.md) | Technical reference with historical baseline | +| Research gateway, credentials and policy boundary | [Governance architecture](GOVERNANCE_ARCHITECTURE.md) | Technical reference | +| Gateway setup, operation and policy workflow | [Phase 2 operations](PHASE2_OPERATIONS.md) | Technical reference | +| Experiments and source-bound assurance | [Phase 3 operations](PHASE3_OPERATIONS.md) | Technical reference | +| Assumed adversary, assets and remaining gaps | [Threat model](THREAT_MODEL.md) | Technical reference | +| Generated hazard/control/test mappings | [Traceability matrix](TRACEABILITY_MATRIX.md) | Technical reference; generated mappings do not imply approval | + +## Browser design and release history + +The current guided experience was deployed through [PR #32](https://github.com/SafetyMP/Agentic-Process-Safety/pull/32) on 2026-11-14. [Run 43645203614](https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/43645203614) binds that deployment to commit `3ddc4ae9a0dc42c5af98fa7818121cf18a1b364f`. This is a dated release reference; later changes need their own verification. + +All entries in the following table are **historical records**. Read their failures, limitations and original approval state in context. Older statements such as “deployment unverified” or instructions for timer controls and the saved decision-brief interface describe those revisions, not the present guided app. + +| Record | What it preserves | +| --- | --- | +| [Guided investigation improvements](APS_GUIDED_INVESTIGATION.md) | Latest guided interaction implementation and local acceptance scope | +| [Experience redesign plan](APS_EXPERIENCE_REDESIGN_PLAN.md) | Comparison, causal path and human-reasoning design proposal | +| [Redesign implementation](APS_REDESIGN_IMPLEMENTATION.md) | Original implementation receipt, including its then-unresolved checks | +| [Redesign release candidate](APS_REDESIGN_RELEASE.md) | Reconciliation and preservation requirements for that candidate | +| [Audience experience plan](AUDIENCE_EXPERIENCE_PLAN.md) | Earlier executive/technical journey design | +| [Continuity and saved decision briefs](CONTINUITY_IMPLEMENTATION.md) | Earlier PR #28 interface and its distinct saved-brief behavior | +| [Static demo plan](STATIC_DEMO_PLAN.md) | Initial browser scope and inspection | +| [Static demo acceptance](STATIC_DEMO_ACCEPTANCE.md) · [JSON record](STATIC_DEMO_ACCEPTANCE.json) | Incomplete acceptance state of that earlier work unit | +| [Static UI progress](STATIC_DEMO_UI_PROGRESS.md) | Partial initial interface implementation | +| [Simulation handoff](STATIC_DEMO_SIMULATION_HANDOFF.md) | Initial browser model implementation | +| [Browser QA work unit](STATIC_DEMO_BROWSER_QA.md) | Earlier browser qualification and its limits | +| [Linux CI handoff](STATIC_DEMO_CI_HANDOFF.md) | Earlier CI route and prerequisite state | +| [Publication handoff](STATIC_DEMO_PUBLICATION_HANDOFF.md) | Earlier remote publication prerequisites and observations | + +## Research implementation history + +All entries in this table are **historical records**. Their code may remain part of the research implementation, but a checkpoint is not evidence that a new source revision has passed its tests or that a pilot was completed. + +| Record | Topic | +| --- | --- | +| [Phase 1 implementation](IMPLEMENTATION_PLAN.md) | Screening engine implementation and acceptance | +| [Phase 2 plan](PHASE2_PLAN.md) | Gateway design and inspected baseline | +| [Phase 2 acceptance](PHASE2_ACCEPTANCE.md) | Bounded gateway acceptance | +| [Phase 3 plan](PHASE3_PLAN.md) | Experiment and assurance milestones | +| [Evidence foundation](PHASE3_EVIDENCE.md) | Evidence primitive and initial limits | +| [Seeded workloads](PHASE3_WORKLOADS.md) | Reproducible input generation | +| [Runtime pilot](PHASE3_RUNTIME_PILOT.md) | Matched benign execution foundation | +| [Replacement checkpoint](PHASE3_REPLACEMENT_CHECKPOINT.md) | Dependency and timeout investigation | +| [Replacement step 2](PHASE3_REPLACEMENT_STEP2.md) | Trace correspondence checks | +| [Wheelhouse checkpoint](PHASE3_WHEELHOUSE_CHECKPOINT.md) | Offline dependency evidence | +| [Test attestation](PHASE3_TEST_ATTESTATION.md) | Local subprocess provenance | +| [Scope and context](PHASE3_SCOPE_CONTEXT.md) | Scope/context runtime milestone | +| [Response observation](PHASE3_OBSERVATION_CHECKPOINT.md) | Request-linked monotonic observations | +| [Approval expiry](PHASE3_APPROVAL_EXPIRY.md) | Expiry checkpoint | +| [Recursive delegation](PHASE3_RECURSIVE_DELEGATION.md) | Delegation checkpoint | +| [Pilot metrics](PHASE3_METRICS.md) | Evidence-derived metric boundaries | +| [Offline dashboard](PHASE3_DASHBOARD.md) | Retained evidence inspection | +| [Acceptance gate](PHASE3_ACCEPTANCE.md) | Executable evidence acceptance milestone | +| [Change regression](PHASE3_CHANGE_REGRESSION.md) | Content-triggered regression | +| [Goal conflict](PHASE3_GOAL_CONFLICT.md) | Bounded budget-conflict work unit | +| [Duplicate action](PHASE3_DUPLICATE_ACTION.md) | Duplicate purchase runtime adapter | +| [Technical report](PHASE3_REPORT.md) | Evidence-derived report generation | +| [Latency step](PHASE3_LATENCY_STEP1.md) | Focused timing measurement | +| [Outage checkpoint](PHASE3_OUTAGE_CHECKPOINT.md) | Matched local outage work unit | +| [Race checkpoint](PHASE3_RACE_CHECKPOINT.md) | Same-version purchase race | +| [Assurance recheck](PHASE3_ASSURANCE_RECHECK.md) | Retained failure and subsequent recheck | +| [Telemetry boundary](PHASE3_TELEMETRY.md) | Optional OpenTelemetry integration and limits | + +## Integrity contracts and visual evidence + +| Material | Status and interpretation | +| --- | --- | +| [Original production inspection](STATIC_DEMO_INSPECTION.json) | Integrity contract: exact original source pins; preserve the original mapping | +| [Approved production test additions](STATIC_DEMO_PRODUCTION_ADDITIONS.json) | Integrity contract: exact separately pinned additions | +| [Current README preview provenance](assets/README.md) · [comparison preview](assets/aps-comparison.jpg) | Dated visual evidence from the deployed guided app | +| [Continuity screenshot provenance](verification-evidence/aps-continuity/README.md) · [saved-brief capture](verification-evidence/aps-continuity/continuity-saved-brief.jpg) | Historical PR #28 evidence | +| [Redesign artifact hashes](verification-evidence/aps-redesign-20261114/artifact-hashes.json) · [layout checks](verification-evidence/aps-redesign-20261114/browser-layout-checks.json) | Historical redesign evidence; not current release receipts | +| [Desktop comparison](verification-evidence/aps-redesign-20261114/comparison-desktop.jpg) · [mobile comparison](verification-evidence/aps-redesign-20261114/comparison-mobile.jpg) · [failure path](verification-evidence/aps-redesign-20261114/failure-path.jpg) · [topology](verification-evidence/aps-redesign-20261114/topology.jpg) | Historical captures of the earlier redesign | + +Generated private/local receipts under `.harness/` and `artifacts/` are intentionally not public documentation. A fresh release requires its actual source, workflow, original artifact, browser result and reviewed screenshot bindings. Do not change an old receipt to make it describe new work. + +When adding documentation, link it from this map, identify whether it is guidance, a technical reference or a dated record, and update the relevant entry point. Preserve historical filenames and evidence unless a deliberate migration retains provenance and links. diff --git a/docs/SEO.md b/docs/SEO.md index 2648cf8..11658ce 100644 --- a/docs/SEO.md +++ b/docs/SEO.md @@ -1,15 +1,47 @@ -# Search visibility +# Search and agent discovery -APS targets searches for agentic process safety, HAZOP for AI agents, multi-agent hazard analysis and simulated procurement governance. Descriptions retain the research scope: hazards are unverified, controls proposed and operations simulated. +APS presents one consistent project: an open-source HAZOP research sandbox for investigating AI agent workflow risk through same-request comparisons, concrete causal paths, evidence and human reasoning. The public description distinguishes this from operational authorization, safety certification or an established result about the analysis method. -The browser explorer is one public document at https://safetymp.github.io/Agentic-Process-Safety/. Its source HTML includes a descriptive title, description, canonical URL, Open Graph and summary-card metadata, SoftwareSourceCode structured data and a readable introduction before JavaScript loads. React replaces that introduction with the explorer; the overview retains the same descriptive heading and title. No tracking, external assets or third-party scripts are added. +## Public documents -Vite copies public/sitemap.xml into the published build. It lists only the canonical document; hash-based views are application state, not separately indexable pages. The existing static gate checks metadata and sitemap consistency, both project-prefix asset graphs and the no-network boundary. Only the exact canonical metadata tag is exempt from the remote-asset rule. Frontend tests include positive and negative cases for this exception. +| Document | Purpose | Canonical target | +| --- | --- | --- | +| Interactive app | Guided comparison and local discussion; useful source introduction before JavaScript loads | `https://safetymp.github.io/Agentic-Process-Safety/` | +| Project and evidence guide | Complete, readable explanation of the case, workflow, evidence layers and source links; no runtime JavaScript | `https://safetymp.github.io/Agentic-Process-Safety/guide.html` | +| Source index | Optional plain-text navigation for readers and tools that explicitly use it | `https://safetymp.github.io/Agentic-Process-Safety/llms.txt` | +| Sitemap | Lists the app and guide as the two canonical HTML documents | `https://safetymp.github.io/Agentic-Process-Safety/sitemap.xml` | -After a reviewed merge and successful deployment, check the canonical URL and sitemap over HTTP, inspect the rendered page with Google Search Console URL Inspection, and submit /Agentic-Process-Safety/sitemap.xml in a verified property. No Search Console verification, submission, indexing, ranking or live publication is claimed by this change. Existing source-bound browser evidence becomes stale after source changes and must be refreshed through the existing process; do not rewrite historical evidence. +The guide is a real page with content useful to people, not a collection of search-keyword variants. It remains readable without JavaScript and links to the repository's vision, user guide, documentation index, methodology and contributor guide. The app's visible footer and initial HTML link to it and the plain-text source index. -GitHub Pages serves robots.txt at the host root, https://safetymp.github.io/robots.txt. A robots file inside this project path cannot control crawling. Host-level robots changes belong in the owning site repository. The sitemap does not invent last-modified dates, ratings or certifications. Structured data describes source code; it does not promise a Google rich result. +The existing hash-based app routes remain application state. They are not listed as separate sitemap pages. Google documents limitations with fragment-driven page content; introducing a real static guide gives readers and crawlers a stable document without changing the established app routing. A future move to independently indexable app pages would require an explicit routing design and direct-navigation checks. [Google JavaScript SEO](https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics). -Giving every explorer view its own search result would require real static URLs or prerendered pages and verified direct navigation, rather than listing fragment routes in the sitemap. That migration is outside this change. +## Metadata and sharing -References: [Google JavaScript SEO](https://developers.google.com/search/docs/crawling-indexing/javascript/javascript-seo-basics), [canonical URLs](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls), [sitemaps](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap), [robots.txt scope](https://developers.google.com/search/docs/crawling-indexing/robots/robots_txt), and [SoftwareSourceCode](https://schema.org/SoftwareSourceCode). +Each HTML document has its own exact canonical URL, descriptive title and description, consistent Open Graph/Twitter metadata, and truthful structured data. The app is described as `SoftwareSourceCode`; the guide is a `WebPage` about that source project. Neither has fabricated ratings, reviews, certifications, modification dates or rich-result guarantees. The shared preview is a screenshot of the deployed comparison, with text alternative identifying its illustrative scope; it is served from this project's own assets. + +The sitemap contains only the two reviewed canonical HTML documents, with no invented `lastmod` values. Relative asset paths continue to work under both supported case-sensitive Pages prefixes. These choices follow ordinary [canonicalization guidance](https://developers.google.com/search/docs/crawling-indexing/consolidate-duplicate-urls) and [sitemap guidance](https://developers.google.com/search/docs/crawling-indexing/sitemaps/build-sitemap), not a promise of indexing. + +## Agent navigation is not an SEO shortcut + +`llms.txt` is a small curated map to the app, guide and owning repository sources. It separates browser illustrations, frozen records, implementation contracts and human notes, and directs reproducible claims to commit-specific evidence. It does not execute anything or grant authority. Repository-local development instructions belong in [AGENTS.md](../AGENTS.md), not in a web index presented as higher-priority instructions. + +Google states that it does not use `llms.txt` or special AI text files to improve search visibility. Helpful content and normal technical SEO remain applicable to its AI search features. APS provides the index for tools that choose to consume it; no crawler adoption, agent compatibility or ranking gain is asserted. [Google guidance for generative AI search](https://developers.google.com/search/docs/fundamentals/ai-optimization-guide). + +## Crawl controls and publication boundaries + +GitHub Pages serves this project under a path on `safetymp.github.io`. A `robots.txt` inside `/Agentic-Process-Safety/` cannot control the host's crawling policy. Host-level changes belong in the owning site repository at `https://safetymp.github.io/robots.txt` and are not introduced here. No crawler-specific blocking or training preference is inferred from this task. [Google robots.txt scope](https://developers.google.com/crawling/docs/robots-txt/robots-txt-spec). + +Repository content, a successful build, public deployment and search indexing are separate states. After a reviewed merge and deployment: + +1. Confirm HTTP success and expected content for the canonical app, guide, source index, sitemap and preview image. +2. Verify the deployed artifact and the exact source-bound browser result through the existing release checks. +3. In an owner-verified Search Console property, inspect the app and guide and submit the project sitemap if desired. +4. Measure discovery using actual search and repository data; do not infer traffic, indexing or comprehension from a passing test. + +Search Console verification, sitemap submission, indexing, ranking and agent adoption require separate external observation. No account configuration or search-provider submission is performed by these repository files. + +## Validation contract + +The static publication check walks every deployed asset from real local links and rejects missing, unreferenced, oversized, private or remote executable assets. Metadata exemptions are closed to the two reviewed canonical documents. The guide may link to a fixed list of ordinary source-navigation anchors; this does not exempt remote scripts, styles, images or runtime network calls. The separate app still runs without telemetry or backend requests. + +`apps/aps-demo/scripts/seo.test.mjs` exercises canonical substitution, unknown pages, source URLs disguised as resources, unreviewed external anchors, stale metadata, invented timestamps and unsupported agent-index claims. The usual frontend build, static graph checks, browser checks and source-bound release checks must still pass. Adding discovery files changes source and distribution identities; historical receipts must remain preserved and a new release needs fresh evidence. diff --git a/docs/THREAT_MODEL.md b/docs/THREAT_MODEL.md index d51ec3b..da1e8bd 100644 --- a/docs/THREAT_MODEL.md +++ b/docs/THREAT_MODEL.md @@ -1,4 +1,14 @@ -# Phase 2 threat model +# APS threat boundaries + +## Browser investigation and research gateway + +The public app is a static research demonstration. Its browser comparisons, hypothetical recovery branches, evidence attachments and discussion-ready status do not authenticate a person, alter a policy or authorize a purchase. Drafts and notes live in memory unless explicitly saved in the visitor's browser. Exported briefs and session JSON contain the user's free-text notes; configuration links contain bounded inputs, not those notes. Use synthetic, non-sensitive examples. See [the user guide](USER_GUIDE.md) and [security policy](../SECURITY.md). + +Frozen charts and recorded events come from committed research snapshots, separately from browser-generated comparisons. Their hashes support consistency and provenance checks, not independent authenticity or real-world safety. A passing constraint in the browser cannot establish that a quotation, stock record or demand forecast is true. + +The gateway threat model below applies to the Python/OPA research runtime, not to the public app. It preserves the Phase 2 assumptions and evidence matrix. Phase 3 adds experiments and assurance described in [Phase 3 operations](PHASE3_OPERATIONS.md); the final Phase 2 exclusion statement is scoped to that original implementation. + +## Retained Phase 2 threat model ## Assets and assumptions diff --git a/docs/USER_GUIDE.md b/docs/USER_GUIDE.md new file mode 100644 index 0000000..cf50da5 --- /dev/null +++ b/docs/USER_GUIDE.md @@ -0,0 +1,92 @@ +# Explore APS: from comparison to a position + +[Open the live app](https://safetymp.github.io/Agentic-Process-Safety/) · [Project vision](VISION.md) · [Documentation map](README.md) + +APS runs entirely in your browser. It needs no account or API key and sends no discussion notes to a server. The browser model illustrates declared rules; it does not execute the Python/OPA research gateway, buy stock, issue finance approval or establish production safety. + +## Follow the opening case + +### 1. Compare one request + +From **Start here**, choose **Explore the approval case**. A purchase request for 300 sandbox units reaches the checks 61 logical seconds after approval. The declared approval rule requires an age below 60 seconds. These are illustrative inputs, not an imported historical transaction. + +The Case Lab introduces two fixed control bundles: + +- **B · Tool permission + spend limit** checks who may use the tool and whether the amount is within its limit. +- **C · Lifecycle checks added** also checks conditions connecting the request to its task, approval and workflow. + +Optionally predict the result, then select **Run comparison**. Both lanes evaluate the same request from the same starting state. At 61 seconds, B permits the request and C blocks it at approval freshness. The display separates the invalid condition from the execution status: C holds the modeled boundary while the purchase remains outstanding. + +Expand **Compare every modeled check** for reached and skipped checks, or include **A · no modeled checks** as another reference. B is this specific comparator; ordinary security designs can also implement expiry and other lifecycle checks. + +### 2. Change one condition and inspect the path + +Choose **Try 59 seconds**. This edits the draft and focuses the age input; it does not evaluate a new result. The previous comparison remains labeled with its original inputs until you select **Run comparison** again. + +At 59 seconds, both B and C permit the request. The timing comparison explains that only approval age differs and that both runs started from the same modeled state. At exactly 60 seconds, C rejects the request because the fixed rule is *below* 60. Reading the page does not advance logical time. + +**Follow the decision path** explains the assumed prerequisites, supplied condition, request boundary, branch decisions and remaining question. Select a stage to inspect its meaning. The path changes with the actual case and retained input; a current approval does not retain an “approval expires” story. + +### 3. Form a position + +Choose **Form a position**. The worksheet belongs to the selected comparison and retains its own recommendation, rationale, evidence, assumptions, open question and dissent. + +Select **Recommended next action** to see what that choice calls for. A current approval leads to verifying business inputs; expired or missing approval raises authorization questions. Other cases lead to the relevant role, amount, delegation, receipt, provenance or objective question. Information-gathering actions add an explicitly unresolved question to the position. They do not fetch or verify new evidence. + +Use **Attach this comparison’s decisive check** to append the actual modeled check and run identity without replacing your notes. Expand **Inspect supporting evidence** or **Record assumptions or disagreement** when needed. Explain the reason for the recommendation and what would change your mind. The position summary shows missing information rather than inventing it. + +**Mark ready for discussion** requires a rationale. It invites review; it does not certify the evidence, complete every field or change either modeled outcome. Editing the position makes it a draft again. + +## What the five views do + +| View | Use it to | Return with | +| --- | --- | --- | +| **Start here** | Understand the permission-versus-process question, coordinated task and opening case | A concrete request to compare | +| **Case Lab** | Compare, inspect, vary approval timing and retain a position | An explanation and a proposed next investigation | +| **Hazard study** | Inspect the related finding, then optionally search all 96 screening entries, the node × deviation matrix or 16 authored scenarios | A possible deviation and its assumptions, not a verified risk rating | +| **Controls** | Inspect the mapped condition, implementation/test links, authority and gaps | What the control checks and what remains outside it | +| **Evidence** | Separate the selected browser comparison from frozen experiments; inspect the decisive recorded event before the full paired trace, replay or ledger | A source-supported observation and its limits | + +Supporting pages explain whether the inspected source relates to the current case. **Return to your reasoning** navigates back to the worksheet; it does not copy the source into the position. In Evidence, the separate recorded-event attachment action appends its trial identity and observation when it matches a retained, evaluated comparison and the draft inputs have not changed. Attaching evidence preserves notes and resets readiness. A related trial remains distinct from your browser run. + +## The nine cases + +| Case | Condition under inspection | Relevant next question | +| --- | --- | --- | +| A currently authorized purchase | Passing declared checks | Are the quotation, stock record and demand correct? | +| A supplier attempts a purchase | Actor/tool scope | Which authorized role should submit the request? | +| Excessive spending | Spend ceiling | What quantity, quotation and budget support the amount? | +| Recursive delegation | Bounded delegation depth | Who owns completion and what stops the chain? | +| Missing approval | Matching finance approval | What authority is needed before another attempt? | +| Replay attempts | Reused request identity | What receipt or authoritative state establishes the prior outcome? | +| Purchase after approval expiry | Approval age below 60 logical seconds | What current authorization and business evidence justify another attempt? | +| Conflicting agent objectives | An unresolved objective conflict | Who can resolve the trade-off and on what evidence? | +| Context belongs to another task | Task/context binding | Which trusted source establishes the correct task and information? | + +Only the approval-expiry case exposes editable timing. Other presets hold request fields fixed so you can inspect their condition. Normal, unauthorized and approval-expiry comparisons include bounded illustrative purchase effects; downstream business effects for the other cases remain unmodeled. The recorded context case operates at demand, while its browser illustration operates at purchase. The recorded goal-conflict case measures a budget violation, not successful arbitration. + +## Explore a hypothetical fresh approval + +For an eligible denied approval-expiry comparison, choose the recommendation to obtain a new matching approval. **Explore a fresh-approval request** creates a separate hypothetical child with a new request identity and starts both lanes from C’s unchanged no-effect state. Restore the selected comparison’s inputs first if the draft has changed. + +This preserves the denied parent and its discussion. It does not continue B’s already executed purchase, issue a real approval or demonstrate recorded recovery. Renewing approval does not establish quotation validity, stock truth or whether the purchase is needed. A 59-second comparison does not offer renewal as its new primary recommendation. + +## Keep, revisit and share reasoning + +Use **Selected comparison** or **Compare with a retained run** to revisit earlier snapshots. Each run keeps its own inputs, prediction and worksheet. Comparing different cases is not evidence that approval age alone caused their difference. + +Under **Keep or export this discussion**: + +- **Save in this browser** writes an explicit local copy. Later edits require saving again. +- **Load saved session** asks before replacing the current in-memory session. +- **Download discussion brief** produces Markdown; **Download session JSON** retains structured session data. Both contain the retained comparisons and local free-text reasoning. +- The **configuration-only link** carries the draft’s case and bounded inputs. It carries no notes, outcomes or approvals and does not turn them into recorded evidence. +- **Delete browser copy** leaves the current in-memory session intact. **Clear current session** leaves a separately saved browser copy intact. Both ask for confirmation. + +Notes are otherwise held in memory and can be lost when the page is reloaded or closed. Browser-local storage is not a shared workspace or a secure evidence repository. Do not put private operational data into a discussion intended for sharing. + +## Read the result at the right level + +An executed modeled action is not proof of a completed procurement process. A blocked action is not proof that the system is safe. A proposed requirement is not an approved requirement, and a recorded event is not the same as a new browser request. The useful output is a traceable explanation of what happened in the model, what evidence supports that interpretation, and what people still need to decide. + +For implementation details, see the [browser domain reference](../apps/aps-demo/src/domain/README.md), [fixture provenance](../apps/aps-demo/src/fixtures/README.md) and [research methodology](METHODOLOGY.md). Report problems through [Support](../SUPPORT.md). diff --git a/docs/VISION.md b/docs/VISION.md new file mode 100644 index 0000000..bde17ef --- /dev/null +++ b/docs/VISION.md @@ -0,0 +1,50 @@ +# APS vision and research questions + +APS helps people examine whether an agent's action is justified within a coordinated process. Tool access answers who may invoke an operation. It does not, by itself, establish that an earlier approval is still current, information belongs to the task, a request has not already executed, or the requested work still makes sense. + +The project connects a concrete request to its possible failure path, proposed control, observed evidence and human judgment. Its organizing question is: **what must remain true when the action occurs, and what should happen when a condition no longer holds?** + +Start with the [live investigation](https://safetymp.github.io/Agentic-Process-Safety/) or the [user guide](USER_GUIDE.md). The [documentation map](README.md) separates current guidance from technical references and retained historical records. + +## What the experience is for + +- Engineers can compare the behavior of explicit control bundles and inspect the condition where decisions diverge. +- Researchers can examine HAZOP-inspired screening, source mappings and bounded synthetic experiments. +- Reviewers can explain a recommendation, attach its evidence, preserve disagreement and identify the information or accountable decision still needed. + +The procurement setting provides a shared concrete example: demand, inventory and supplier information feed finance and purchase decisions, with an orchestrator coordinating work. It is a way to reason about dependencies and authority across an agent workflow. It does not require users to assume that the model contains independently reasoning agents or represents a deployed purchasing system. + +## The current product contract + +**Compare → Change or inspect → Form a position** is the main journey. Each comparison retains its inputs and starting state. The interface explains a case-specific causal path and distinguishes execution with an invalid condition, a held boundary, a pending review and an outstanding task. A blocked request is not presented as completion of the intended work. + +Recommendations change what the user investigates next. Current approvals lead to business-evidence questions; missing or expired approvals raise authorization questions; replay, scope, delegation, context and conflict cases raise their own questions. A narrowly modeled fresh-approval exploration creates a separate hypothetical request. Free-text reasoning and a “ready for discussion” status do not authorize operations. + +Supporting views connect the selected request to hazards, controls and recorded trials. They explain where those sources differ before showing the larger register or trace. For example, approval freshness is narrower than quotation validity; a recorded demand-stage context substitution is not the same execution as the browser's purchase-stage illustration; a budget violation does not demonstrate objective arbitration. + +## Three kinds of evidence, three responsibilities + +| Layer | Responsibility | Limit | +| --- | --- | --- | +| Browser illustration | Explain fixed model behavior with retained, comparable inputs | Does not execute the research gateway or demonstrate a real-world outcome | +| Research implementation and frozen records | Make synthetic experiments and their source lineage inspectable | Finite trials and incomplete measurements cannot establish broad effectiveness | +| Human reasoning | State the proposed next action, evidence, assumptions and unresolved questions | Recording a position does not verify it or grant authority | + +The [HAZOP methodology](METHODOLOGY.md), [gateway architecture](GOVERNANCE_ARCHITECTURE.md) and [threat model](THREAT_MODEL.md) describe the underlying research contracts. Those contracts remain distinct from the browser's teaching model. + +## Questions still to answer + +1. **Understanding:** does the guided experience help a newcomer explain the causal path, identify the decisive condition, distinguish illustration from recorded evidence, and name a residual gap? +2. **Analysis quality:** does HAZOP-assisted review identify additional applicable hazards or improve reasoning compared with an equal-information alternative at an acceptable review cost? +3. **Control trade-offs:** under what stated workload and trust assumptions do particular controls prevent invalid actions while leaving a workable route to completion? +4. **Human judgment:** what evidence and accountable review are needed to resolve conflicting objectives or justify a new attempt? + +The existing interface and automated tests do not answer these empirical questions. Comprehension needs observation of people using the experience. Method comparisons need a fair protocol, independent assessment and preserved counterexamples. Recorded counts should retain their denominators and missing measurements; clicks, completion rates or model confidence alone are insufficient evidence of better judgment. + +## Direction for future work + +The next useful work is to evaluate comprehension, improve the explanation of residual business questions, and expand case coverage only where source evidence and semantics support it. Richer recovery or objective arbitration would need explicit state, authority and evidence contracts before becoming an interactive outcome. Broader domain examples should make their assumptions and limits as clear as the procurement case. + +These are research directions, not scheduled features or promises. Contributions should identify the concrete question, intended behavior, meaningful checks and remaining uncertainty. See [Contributing](../CONTRIBUTING.md). + +APS provides no safety certification or production protection. Its value today is an inspectable conversation about conditions, consequences, controls and evidence—not a claim that a particular method or control bundle makes agent systems safe. diff --git a/docs/assets/README.md b/docs/assets/README.md new file mode 100644 index 0000000..e674fcd --- /dev/null +++ b/docs/assets/README.md @@ -0,0 +1,9 @@ +# Current project images + +`aps-comparison.jpg` is an unedited 1440 × 1000 capture of the public APS app from the verified deployment of commit `3ddc4ae9a0dc42c5af98fa7818121cf18a1b364f` on 2026-11-14. It shows the illustrative 61-second approval case: B executes with an expired approval; C holds the boundary and leaves the purchase outstanding. It contains synthetic inputs only. + +The identical image is published as `apps/aps-demo/public/social-preview.jpg` for project sharing. SHA-256: `45b25c06e54b8087768f4831049e41b1c69896d9f8eb6cd53b2d0a27fe19305c`. + +This image describes that interface revision; it is not a current CI completion receipt. The source deployment is [run 43645203614](https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/43645203614). Fresh release acceptance still requires source-bound checks and review of its actual captures. + +Keep presentation images here, outside `docs/screenshots/`, which is reserved for the exact seven generated release-QA captures. Older interface imagery remains under [verification evidence](../verification-evidence/aps-continuity/README.md). diff --git a/docs/assets/aps-comparison.jpg b/docs/assets/aps-comparison.jpg new file mode 100644 index 0000000000000000000000000000000000000000..0ea924978db847242da95e58e2a325b8af410f26 GIT binary patch literal 97050 zcmeFZ1yo#3lQ2AZ2yTPB%iwMa!QI_8z~F;R5+Jw*hk+2>-Q8V+ySo!0K@-AH9(kW< zzq9YV-|jiP-#P!;zGwQ@?XIq>zTI8-_N}UUTzK37V9H6!N&#SC005Y$1Ms*7vmh%j zZmgoFEG4TT`Fq76;3>hg0|538t}bfQuPAhM^(c@wesA%s&eR;@^y~aj(i7e5xnI-) zfN9V_!TDFk$QG6m^CyJ!ryq^W6Z0owai3t^*T2IIzhJZ9Vc}n}hpUt86OPI+*hNE4 z{0X*rf*D@_4L185Z0_Xp3qSG+N7&xZ?H8|K>6gT)mJXWgPv>V(KN0{0pazfzy!zGu zr|YNWm<<5%UjYDcAO0#cO9cQLf&c)5rN7E(G64XL_W(fs_+Mpz-4iEM7t`O!!9V4& zR#pJOWdQ(yrV9YzOaK7S^?$2-%KnLL6i-zoPjWdv9j^g)080P`Ko;NtFbA+cL7V_~ z00)5gaTy>EKza7;`7>}*+ z^!y3}BI1%VvNFuP%9=`28ZV_~B!3ZsK}AEu!oZ@$#-@~HrDv7=Pp8LD0M;|O1B6UC z7%BiP77QE~%wz9U2VelOa4^4S;-3i?4jus!2I<*Ttu`hA2JY825;7bzA|ebd(l2ay zECg&yL>vxPTroA%I4Uz||JbZeJRql*OLo=d6gAf?Bwlq5&A^13E_@oE`08_RONeXk zRzSBnt)%${9iPM#VZtYlztW#PpUzK=;1Qmx*s-2?z{0@6!6Lx_As7r6EH)*asu~VQ zmY69nr+-x!JQepjm$>sq?B?SV02S`31r{6@;055WnTkyw3kwqq3+7*DNQXNTIy}G* z!bdv%L{ywE@Ee}JIxRvt?0j3rbpb z+kMS0O3-ea4n0UgZiIId>0UKBDbHV0Fp40|$y|EQuvqGHB)7C^O2okWREl@c3a<4gCbz8*O|VR*_L-1KR-XG&$7oP2D!-7s)A1G>pyiOFxcFiw_@&)`bjZr{=0#FqW2nh$EG{>R9<|#Tm{d zoccl0+f`}Kfr1{4rDe^t_-$2HugfbbC@-*-q#1?cKj2rc zkmb4Dozl&Xh`%#ApHQ8cme)H3aAFTq!R#0u`}r|DxEEmdIN1)5S_M-a$Y2gB(r%}J zM5v>ABU_quH0d0*R0>AV2v&e#6oiL2b(Q+E3gplSgFk(r)mklHdcL$`l!n@KXvvKu z(6lCVDdq$_Kij{$f};ys&Yrew=XVc8ur%Mol255RwVB#Zt_2}t)HSX#x2C8})rTjk zPgykqBW+zG9w=D7oYeB{SEx4L_?bE6xibvQk;ey~Ho2}hfZ8g+kAQ+E%X#}mgWDDc zcK1nkK}03maxd#QCL~15SY@F%m)g4WAy%z)-TMJM#k>W$dG5%hTI8g{vsXf?DPN)8 zr-V?k)b1=h1mgTFXb?#omJr2{i-49`&AU zBy5MzXD|HKL)A}2C<`Fw`8@q!z@cw^^Lvyxt52Op3i~P#57-w?d$xLQ_4bEYDxCZS zb^vH!T#!U*b^EC4E$Su?qh|bKriwekRYXf(Z!~hEGqeQ9e3i#Ya?;$G7T#{Vk>8s? z0;XEq-uk|{xlLMqVb^g{B_VlWMMVWmMe#qDv3P+^!(a8Z`lNwFvmvK%@Q2ZoUgcoW z%$O0K7n1Kv1#~2s{tU19LDP|Eh^F91*zhzIH9V&vr*8o;x?lj#<=D&ik7R83xoZ7# zAcq&)JU|TYZ(oL(&FAH^s!}V52`ZB62LxJ zdrrSn>M+SO>&M1*PyTY`2^Gz##RYIKvA`Xz0d3rfl!t|_F zbTiu)S1HH|<`XpNmsTbtS+ppgNE2T?t-U76{0JgwS%t5L+H-AWVp17T!TS58E0my! z;8WDn-1laf!f*3iL^aAlH+1^A4H#r(S|T*hsqI?WZn5wz&LlVL7O!I$|y{XJHcY^GE)QSTP)fbA=CCsBLl3& z;$lEb*_3AFNdG3sQ3D^5;}&q>5(z(+Q=3srk~%uD#NwiO^%J=G*khrFNm8EZCaxdF z515K$&H z4Wy|MCrIZ=1c9AE%v^9f*4!o*3fHs)5(an4L#vUAEMhz-698w`_H%;s?qRhFcYQPq zb-YXFUrli*XPe4lWsH9026hInI(kR8kVeb<&kdiCCotRgepTmv2?yo!;%jSczV6V* z`}U0eNY1wCDAPYOBj=`q#Q0E`v8rTWqlGW*V`gTV6*3~JA~DIlH13!)5+lBIdqd+! zgAh-^{N{H;O)*Wxvtlt;ov*d)Ty{K&Bc&4Q`EpK}CZ1!gqnovHCf^dr!lnohtsszy z#t(Ym7p%2-czd?+bR3ulUabfuqJs~MP?tOB`BJ~xyt(@JUNLu$gyz<0(jMphNLVYJ zNKQ|d=*|*5gir=J0hibJQ1ZHlU($g*>=b@h#bLX&i0%Ep&F7VIzKO$LXTw*FU?oS> z%HmOS7&l%@^gVN~Ps!}=@6jujX=AEW5H#sv!Y0g|&J+!%bgaPT1KcPFe$1s3)t`9t z7t^%@(snLt8r=;1_i260Z3rEID7KA1THW>?kg5IH>n8?R!@aNwHe8zR|0jA)m4U|4IE$hN8tCe-yUvS z3T;!y)h!Aqze8`JNp^#f9yduW$@#ADMYBExSt3b;naxVqLnEUu(-NYd@gDEb)GyQ$ ztkEh<^B9d!YSu8npNal}Ozrl$EbbZ*Ss=McWv8CFkp8>@$r5t3eK4sZLyAX{?9~kW z;Clr()4=`+=s$Y#ZQv1*XQ$PizTeM8!jHH-U$E1<>eX8L2w30Jcg@aW`(gLAY)1d( ziuu>;>Az5`qoO%IsWBH`9Gbydgo_Nu z2e}DJvPq(eiO9>{AxVlODkGnQ0{3jS6>S>{b%`+@7Ny^;u;_g~oy0ayCnrxUTLIaH zW!)1#L1LpF-gkf1)X|{3UTBeMv_mR0e6MYC0)Ubt5{^OR5LyhvU>FDBOe(`j1qKgD1XZz49l8Qq8=X%x$hh_!uu}JLE z?8k=<9DFtPH)3vu9&eD(;ee#-p^j~@?|Kb zMvHc8Q7;^<>0Bo@<@c2XDPNb+zLwAbAf#(*WhGQv>+D#gdhkVycINd9ts*Qr{&nus zXx?Oz9iB20Sz*}2Vuto{?H^E+oY%Vn8EL#AQg$j;uCqf>)`$;4MnryBNJJjZePVN_ zj%6HmmZMr~C8D+wmX*h#UzM3d(S@yioBze-+jm?~ef5D#`umXq}5_ z2-dy4u^N4P6}Vls@MjiV$E9+D?TbSBFF%s{@V?z=yv1}3i8-71%~5@LW&C#M6T{3~ zmE`q1P&j?T%-7pMU*WgzEq@ZFxs%Gdf8YKH7_w6p5iR)COT4-Ly>9)FCiKHRLMzi}o)NZ#{pWdi>Es_A*NP3fb=w5Vw%+?Wg=A zl&@#t=HHPQXZpzNhgdt=ix$IwwD?o-dWMWo>f>8z=NAu4U;gM}{GWo;R!RKdb+vBR ztp>G9t(o&}*s9TNyrc}H8AbZId%4Syob1MZbs|L-os&y3PA8g8PKH)cd>d5C$7J5C*(Z zZ0f$hkPe=j)-;{82yLvE7jE7;LeITqwyFGvUeNWrgixZ6l`?3BW!e8r^Vl8sYrEV9 zi_3a1aRZ&}_@Z{JwTF9FT_uBdlZw21mq);X{7?NvrX%A5wx91icAIo;M8^b=-^SZf z?<$rT_$+%`cNMzbMG@bGie@*_&e^#yNmr|A)-^iHLGwCOQSVp)yue}ap<~0bc?=Do z_7-$Py|IeIK2lw*+_==*(*pca76;_3WFPI3#H=(j5NFmEc9_zl5XG6Kk1Q-jrEQ=##&ka zY3_;8GDK>!l6eH`F|xFF@33ii+p5y~rWDcgPCVW#;~En6#dPTgM55M?tjnUr632(c z(-TUqq8aHE&sH+tpxT40LF`ylv9^m2-#;I6Wi@=PAEL^v+u%e0UaaQZ?N7uWRJA05 z$(3D*5i1GI3>lHf4UO?|I-YBlbhHV()(Amk+$lv%hBo)|j8+8L{iwp$EIcizJ}#P* zv-2x@Z6Aa~BM`HxC|DRdB6$f>UADL*eOy7Vr|{n8 zt$k~ID!S32HF;c#K=ao!b7^E{$huhlgXXAFQRYM}M3W}4{HbY$=DscO9|5+iZ$n@2 zePZ2wv6NuEMR->-CIP~Cos8fX(nd$}|Hh0xb$Ql%=YjllCi@Y9IX)(8*!{MSp`(}U ztFCoY$I3scvgH^Y(jmuLx+X)nX=JqV^7!|emDXWi3!IravD()F+{hB@ex98;COdsP zm1Da={V~0}LjPSY;)nPPo}{qXHynR)R{jUhoF46`e_dY2x@aHqb>A|2ZT+aYk&zbSe@?^tB9hkz-r0;h#-|p|Zj9!>yhf8#YA6Rn zYi=}v0&FzEI?%ZlU%3a6ZEcfO_agJr@Je$VTphq-ak;VVNJyLg+h@i9gE$5QQJ zle6kcd%e5n)BBS1SsL?551VfTU)>3Ivb3D{d+bL*(ylteA*mI2<0b5&Iz?`}(E3|MjLX((BxFvh2{wYZjBTs+Mq6bkX6d{_$@&Nc(}LD3 zI;MEk8eY=bzSI;dUtAspILRGL`&Sl?Xs4n^Oro!FVc49TW=q`dIx z{LGo*^M#xwY$`Z*XR6Qm)2jAt;~Ev+j72m>oEm3R_f{{*7M+|->+|o8-%Z>sBBlaw zo^{*Uo?nQ(bc>QYy>tzhqPF)R+eP#I2wP|}v&X*%Hh_6IBRa9p3vHOdW7+#UQzGhsC9BMJv`CojYM2g~tNVfWrK}uz z!g(uDD#CXx4ZS1@N0nKgU_LnIh4pb9D{-0%s4w?|h=qhMBicKRP@lp+^*j6i+0wp& zwV}B^+wAc(o`Z&}lkEaO<1Z%c$(H6&vQ@$~?Eu8=xk_P2lXBu0^4iq;^1`tLB^#9xBRpAa{?Z#}eM9+);&mk> zvV#+nmvtXaosam)atRJX--U)g3l02sNyS1G8X9OE^>*Xw>)opQBOtvmo>@N2M=H1W zT~_F{XmR8KX+x9`js2KE$jJ$5>eaxV9^E0W2$+0sEsVPC7%U^29l0O2n}0{ukjV=g zNMb*rsCR$hZQgO#jf%k~Xtc3t!_{b4-1}z9ky1(wUYB;$Z?pPQq5Od7cuUyv%J(0T z%V&;mk-S_22YOK~RRnqZ*i$GY^_WP;k8*_d{+AOrh4^z_uSevKh{Hz69;SqYr~6-5 zq7IKN8>00zc}t$vh-w%73~%^>x}NnHBtT6fRHu>RPGKB8rnQ)H*!XQ1K9rX_IGywu35XH7htSsC8GX8ET0iG{^ZqYrXCD1TP|jDe z@nmY8COD;O(G4M}*%Dwi5mPOA#RP@2i0|%?D-5NP#J%!}Nt11@V6BeL2Xz0^OE}F{a^3HL_4=d zg^$sjjP^i z(c6%UfY)c97LemHxE?0@Ne~oLrLGx?Gus{kA>xCA^RtQzADO{| ztRAT~h$K~wwfqt93=sV5n-d7FEA=BMIz)BT#R>M;-H!#zw)6`U9ga&Fs)+2w%H6nD zHkOUKNT$sTc`2;DW8ev8syLX27;HQ)x@lp?&=KzJkn3)V?}2&@zv;-YF*&lhZ8 z7w`qxP>Gs{{=kz7X<^$n5Wl}t{;~hY=CYjf!Mormq=P3kbl<>-(>Qc)c%@oPL!|X1 zbLbB(PAV1&>B=%Z>~M1>QtOD`piGQh1pf}Qno~_GX7{n&PnqMWk(`R`9|T`*ASHim zP4o7|WGf5PQR-(lPDs^H&5Z2k4G|gw%`EM|k}5&Kv_zFFlrUR^BMg0|r!&PF=)~{b zVT@tA5h*!%!H){`)jqJii2<*B2-txY&L*Dwbed* zByqWZ@6r?2-UW#|yIX=7aoeplL1w-eMO<8JONg^KHbJj*CEj_=d}>}<<`7lM1{+1B znq8zEzdfrnnwb>SPD&^g_G`Nh8%>;OfMV-M0Fiz`F^g6?e$!ZN0hdlUIkCYr zlNwj5d4Tg)F>x-F=$T{1y&YYc^cc@v>0RX^jjQ|Ejd&9FjFWKtHK?+secDv4%?>+-ajn%nS#D9ZcM;(tD>8Y}Es zem^I#F3;^5p*N>~)`{i}+nZ)weoxHOSoOmkcHoG?xjCi83^%3-oD<0&0c*!1JjK(Y zW~<*Md3jNPn`0wI=d8ykB-&_oY|zj!Rrlq1^TaSiC}IS0P%&KP1x+weo;Vb-s~2*{ z$Uh2P%f37LE?!Gu1Ow#IS68MejjEdNBtVqL^4pGTg3CKCRO{hwE>9!Q&MWRKau)Qi ziTxZd9E?v!`f6*JC;s&WmJ_bd+O)YwVq+ib%!TU9{b03rcKJ?x!KIsqw|GY6bvm`D zi#4<|B7)gc%HMhKUJ7Ko*<=ah=<@oZ;nPOg<7pArtrAWd1qk4vd})ylBSZUAR}w@oVxnXc8!^AaY6Fr#0e(fOKwHV-7y z2S?jz)_dk$>!T&bsW=lFGNyL(exhT4GLsWw`pF%SBm1pOOZLp$2gy5I@8o%Mvu}1+ zTUW<`K9k9`mGeM=+$nQ2swN-oQLnhCrUv!))tiKY9;g;eo~4Ij5I*i|o-X>a@Kupf@?L zBGQ|yrxWI7Xi%iBU^8KD+RmaHDyliMZhRi;V_i8)l+j-7?UmOnPN)c{gLo3_JD{l8 z+-Oi*ztwmK6TLZ;GOK}CdmC8Ia}vqk|J~mnF?+{HU2Rp0G<1c+Qj9D^NLsLwiKTc12C$&jt@Hp09sucra^btT$etshV2=IOcbb>@NfIOumK_--^->?dFrsEE( z(v7O)!R)pKv}pOoV{KL{5dDr&MT-Wxh<#k0&$DJJtdxez#_)DoK0|bLd!Dent)R^7 zRpYM>z`m?5hROkP1UFv?-|D6YG&D$>6WVul#?mw)!m8ru-utTZD#U6Fk$tI#-w@6m z!ESi&4uT~H;{%+<-5Zg&e~&=Ok~`rbzkZlN_t*IzN1 zewP)+sMZl7rKu9*(TLkCOfanC7Cv?~ZZcH-q$2tChmajOyQn$;Tu{Lc*h^LTVeGGc+kc$TcfH^m{hmB{)&#Jt;m(n!OOf4?jf3b1~&wV z@b~Rp_iwHj`DnrYJ*A{Lg|FMER`Ofz(Gb|i2h>fQ&{f)FsM|=_oKKC6PFzKvusP>2 zJzgRy+nM!-fq4h2JxoFZ1Lm%=x9e&un+Go)TZfrzj3NT1sPXU+c_j|AOhL6Er>c>i z%L$_+`_4mI&!RR1$7udhH#GCK9i#q5spiCLiE8LwrS0p@hv!M(*zv8XQX}o}Z-KG> zYklecNm6r7yE_1skKmTpWl0(pEUf>uwOB$zOjAOH3aSHXOX~;jnbxE^g9B%@iB2%U zsbajq6{+y-IF&ue{ZWfS&%mrbuX}BW@ZKr)pfpo3!+OwI(6~Hzt!k1$Vw3=xtTSt6 zhki_@ZSk94v#GwwFSdp2tP~5ENqb;13~(qlYe08TjM|q;!#ti4P`KT!r9Bx8s@hA^ z5J5gUgYDOrXh^IdSKZZn>#Yo=ZS{?*w+@tY+_)o0A$MXuil83`^9tbxW&GjxsY`-H zR!;_lMjz{iFLYUxI9&QZOTGF(Z_7hSyYqYNU3_^nq#TWjb>>GhCjud+t24kw>|u!8 zca{@ri^B6FD?2yts)0DEqlxSKwKQkV&0D1>1s$NER2(2^&0n1avJ!QsR#rR0VktoQ zs!!5&$njj^1y+F-4!h51_jqQ>IyiZwPL%aF6O-i^+L3k{Sen7(Bs>W`*rFo4muZb; znchqIQ-koBl3iQRBb}vDI3@b4a&Gll@RroINzsS4W>YSDIf{#QQ$buCi62&gA>0wX z+rbS@$F#4~tlXo6Qybkt4rEKbLPLeF5~Fi#*HyqrKs$58lSS1fr5rhWL}hPkMn!8< zki83$67R;U6Pq)}xFVn{-sDKXy7tyh#KMo0C?o!3=gt^d$C-C?_Gs3FA%CiNQd+rI zsiemOS{_?jRel)TKm9r_&9bor#Vxv>*;8`q)fFzu&;AV_A(8j8vO2e)s0&=*^~wS% zb4tc^#Pjh_hDYUrdBcFc~{T-YmP{9!tC-TqGs*-5FPV;q+xexn*SiV zw%Tzls~qGzy}!l=ccQbVD1EbSh}<+54d5lw3Yx24XuY|0<;jzeMh~;~HcyQ}w*VKW zo`DR#;PPzc?_{fzk(#s($d{_Sqin za5tbwvvl{gD9X0C;#-8DGOFxWilmnI@Ot3&?8hM~>Kw|G3}8>D`e)ye%+;mggiWcK za;a)g4}_cEEy*@TokCWQjpjGD_}$7+acuNL@X&|N)yyGgIzg5!)rxYr281byjkWIp z4Uq$Q8X7afGQo0rh_bXOigjov71eLstKYsu{lCdxuxC@Pet6pB<=U@Y;?~vL@yb+%}A~S%QT$$So(nAfgUapO}$K@3KETEV+p!7^w(tHE@ zL@?|W+=x8|qsrpcwj`x)UH~_;62MRzmtn0(%EHM`%DVR zwO5ij<7E>X{-gwV^PLzkJ}(I@29{4^UsLtdeyBk&%_Om_uSz)BkD2>UGyyL=-D!xy zIhwDPFAOYOEsY!3SWhRggR+=?PZ7Z8(!y$&KVNq`7i|NMFnC6>5I7Uq`@1*N?@mV& z|AA}Lf5DaFf5vg+Pv0tHJ9WJ1Y#e0(B*nu4vT`Z8G~z|IIIv{Wt6&pPMo60mRc6NHnG}vHgSXPegp&rGpY?o{fM1U zrG~!TQ@8Z^z%#KfmK>a{mmt`-DYmqZ^nJ*y&0 zU<5&uP%_&hg9GJ#vyb{RW`l+Jv$-9rU<=KQ?>*30A(Q9J>uU0ELZ9x=(GH#Lz$md` zt({G^Ot7RLK_|j!{qhK)5KIcgbZ}-Gq<0hAg3|M}v;?O@P`Kfod^5`PShTV7%JPd{ zt!A+`dHTmFM4~WizDK3Qkk0Sbh6eIBSI%@vjU8v02am&lB>gy0(fHmJ%VY|?tITfS zIv4TDC+$Q>CeS8OQ(C#ru4aIkY!90}9S3|wGA4$9JaM0R>*j|>Qs*LPnV=!t+<@c| zCJ;8Ybl4NCCn469RhCqat;EpeaL)Rn&hlQU3JlGt5USJ`$I%p#thJm(1gF1nkc zje;&1h4$13R|0o>c|1*vrtP3=O-}1&x^vykj$oy#6l+(VN{wFA;$Ws8x&6;HcID`V zOKe%g=-C^WPdB+ezmJi+x1`wU#v%WMg_ZmVM`zkb!&dvz<)FD}T|or}FMG7XHvjfJb6Y z7z}SCybfjqe=WAg##QC3m8lW{*2OH+slzA!fEe$UYc^?kZ@&vyT}e@|4T7KIM0=3$&smz z#ubf5EutR+E#auLb?AjS4I@@&4#YlJ89#|w#?v%w?D9EYn%nX4Xga1QJ6-mhY`O^e zTiRmpR+TOtk;j6;l}$Otafw;|T<#YXZV}5y%$$MN=dBV7jK^k>4J$9HOm4Td4C+=8 z9j$bPIlmIs{Kf}0g?o2N@>7CC3(C&e6k@~(C#Itna;!VcD-F!5`ff!ovaOYtm3g#= zoaP}FgZdeL+4ozB4pI8V4J@25*g-W&__hcG-q#V1nW)(Z3irxiWv0db9?j4qdDO#4v-TcPftH0yB_`;wV5kD__gI=)`=lSjNwrQ6$up&fdEL${uPU&kpIIb9trsX( z6$TeGF9W+~`+o?=WsgAZj@_%7{Bk3nM|gbT^5U)-D}YYGG}Sk3l=sy4pj2cQmbkW& z33^z*ImZI0!S(1bzngs(gIW?{YjbQ7K6BEYrnJ9DBt!0_ce6R)Wka*LqI)Zm;71Um zwk5(!&*|Qf%bjch_k+f`j0xTF<&pyJ3}UTTO%77%%H^}+?HS2(5inI6UUo^(m@gh0 z_dEVn#U%iVQhU(gP)*$|E*|;;7q4D;BiXfvCa-o=@J{CiF5kex%N z$j};p@cp;z++LExyd?v=dZsYOW4-HX_93>o4ZX=9T2wpU*bz3BzOOR7WDQBGgI^EB z-~-!}iSF^KPMC4un9^UsHz3s!#fXw_uM>YmA7%U5hoXX8JAK zDP4}l3O%~J(^equ=KfU7<*@L&0I{Mt8k*EDK=;8gstW&X#`$ckEyU*BJIpd#@OC82 z{1a^#jDLP_oD{TN9FW;t#X|jh!yeUHO>O3Rjt(uE3OYTj5g*?TLao)9)<~6SFwwy> zg2C5zsesMbUZ&kU5ZGZ2e9)+mcEE@tk2v#!+54!?;SGI=i9LAf!563~#S=26$gPQ| z5Opp=7thWMmaXL5EIQh1`Vz}rHTtT&04vLiocR2!)WS`a7bL9Rp1V?5M4l`eaUk{G z79K`eSwEA4!l2Or>52&&a*LR#s$9TseXo0Sv@mP~R`-sjdXYR_juXT_wbS+)Qt5Z# zS$Ta%K;jjTOFe-O>we<_K9Xup%9tWh#9KBpv9tg)?1!wJH#W`+mEE`n|3($;=)!smusJ`DRAD(qNs+B2oviof<&l` zSC$B2%t_`NVXu$4Fhw4~WHIQyl}!i72*8KFI#?a5*v!7x55fS0mlS$^4E1Y@nLSjP z$umD60lX)O{K>oS+Bz_P&r=52w+$!y)IIKQ+^gyxK7;ih=9_0tQZ(Iolt@8_{E>ZV zGI8VRXpmiWYmzh8(w@wUEYzOW5Kf&`wL3xeTnB@^-T8*8@v=tm*+M1l%`|yw1M^^A zVm$TTI1bW};JRKI=v))*b=#G$ig}8gqN7A`uAom-rX>Y`LnwM(7-^sFX18tX`-xX3 zusY5-Lj9&WeC2Lm-VBi*V<)5c)AX_5fhp6W-XZO}q})Cwz*g9PH2cEs@;2{0F_-n} z?G!gn*#M#shX7}M8{-s>>?Ialns8A|3l}3dZ(?ct`Qj(FUcGl94bADzb3IwwbK9MGos7f7GAPyZ-)P_^-fC!~ zvFYYAuPwD8Zd%^6tlSpW$&3H)q9>{~3ycs0LZ=OthO_9oXOqZH0$JLuwT%wL*}aJ| zsy~toO!^s!o!7hNTI=$~9C5Mw14j0?vD&cCf-h@9Pm!sQOEZ7U)a1;|C*4%r9fvk; zktCM-d5n4FV-bA}NSkTSw@#bXp4(05Nt+cZsFGgowuQB%+9QOh@~XU<7@il+RD}y3 zcp>d3bu%)SM(Hl^hk44sUOs}8Ij^x*TgTeHEU!<}Iioc|?IKSA1i{`#brN9}h~UTc zIHO0fqAuxA%W7HTc`YYMSgc`z_r`ji8Vu(R=vju#GLw)r6-hDU0-_aHz7pDPNY()B zm;C+QNZs|liyIkiR#nw0qUn~-MD{v8(#qW{(0e@yGVl>tJvormuV-Id+u8fo?7^>X z>+67>>ThQmi@H~F7!B25bB8Xno_6;V*R3i68#fQtgG7ybya|gBUsPi|gtEBXJ*3x< zy*XwhttBwG$u8s(_uz^kv}%mo?5nT)vf5|U%qz$sm8kSuZY&6L69n(pM&m%^E`>RdFR*k+S>N_e zP#65hUA&oxyyhUgBiqs8P4pL$)6e(1+L!ijwAN+O@qW$a8LB8o69xmdsAElaUuI;s zwD^WniXvxx(^n7s`mDCS*H_Ov+rEI;*H??5-ZKJ(A?R`8a#b3W@Jhp%8+v+YlDS6r zQJ}e4^Ay*~s*@r@LxzxHbEx<@;s?p)H{U_rjSiHWASvoeJ~e0xttIu2{n|no;*J5V zV}3_Bb^&@X2XKqc4Y<9Fg9}sPBO4Uew#&;qR{jpB5cx?N3)(i?_6C2v>viO4d}p8H zO!_lVokLKTGC#Ejj#T}|DUBR7N4M_!9ghG__?wP_Ya)9+pL#s8!4!yD8tG!{hvHS+ zTvA*Jt~q-+BLj+gW(k|0)KyTqeFhBd%}+|7AVz(tVO9^bt$9H~F-DyH4j~C#=oSps zJV|4ztzVx1^n|(+8;`lc#(~ZayY8Y?UQX15)_jrq)FzL!sV5B`V3E=GruyC99jG>0 z*zI0CgolWPw>fNqCOV((;K}m>I$wW+0g>?_eOX^WtM`7lA&|J|2rS6L12b*diCPZR z*ZR_})PCNqW}Yi}VheYn_7#y$k#*0G>twsTJaXHK`A-U2z9SOtmo|YVgzBvcz{(m5 zuR#Z~CX#PkxuqP(7f=$8Q%j3GlD%ZaV1Zt4XS!ed1W!{)JXm#*8d`{y#H&IyAT-EV zQ;Vd?f5n38orYUj2Fj22Vl-CLnS?Kmo-$Y$5ZtY6^f;)ywJz^*2KJ8f&ng1(<#8kJ zA`zkq`^ptV8~Lhs`}E$||17X}8kVk#n{D9Q#^L5De`7_w*xh-UHLGOcfgUt->Lx>% z=YJl|-6G@_0XGIo@x^OoNvIjrsrk|geR1j{R3>?`!5wi)$Rbvbz#KOe?d>fa3y zms#8UAZ~OBR~_A=_p`TYi)Qm@np$BBo2M<%>w%7Wu8}p10CCTX)5#bti0Eafh*9R)s+vN7Yo%)s*4Ip zjr#_>^^7%PkB?MW33`QF$f{ehBu8jnLYtlP^gI;WM+HG3@AxC4B=7rfOTX&l>Nu4a z`Iv=Dk=@|rxEjPeMH=M}-W44|(gi({3p4nPv=JA$xfi%&@0KgFdMV5A+M2R}C3bcI z!-k2-PMo|`A7lC4UKHwq%0-*kMR;OWFJC6Km77}L8epQg>DhiTzqOZt?dqlo`!PTk zQa8FlfH+;t%byv6C zqs4ta>`B_bxiHaYduWp*2_aT|04$$~0-(#Xra7njmaA(UqT#AU0H4AQVsK+^b0;|M zAnnSdWHHM0OZkC)A);?z((p-MPlR}xnKbjNxu)qAtHZO&@8+^XhFoWe0rcE0MuM@Y zI_wi$nA`SlAntDyf_YQQPM})(kO6LQB{>rV95X|6$WR6s9g?EnGe|V=>IDI^PDHEuPcWG zNVk-DMDdjwvOmm)1zy%?Q~lkr@2N*JH4hM*2%O6yQSBa$m73#=f8z7sA6NRj$K}%< zW8{dAJ+-iB^@)PcMZ|d_xY?sAk*XbeHyYxW&D0HYO#aJg@i!R~l7XsNnD`>bb(Laj z_qNYvFOXAndSOp(c75wQ?HyM_Y#0Sz%{s95WCgYEu z4YS_s9rrlbG~JwTT7e7lJXHE6Ll2AUC|Yj#{f26A4Bg(4mv5VBKW@Dk9$43j+~AFLh>;j7~x|Jc|utM}!X zdU0U8(rS59FN@jsr18_^<69)JKd%@cm3gc`Ab)MZzb`Soc?7&VndFTgDERcL_n$S5 zQGW3v)cKQ;^V{OO^|#;X|D=IZBe5hzmht8-=C-K&)+0a@{1pE5q?!KUk8c%L>n_;S8JR&VgEP3OosH?Cre~W>m#KQDg z=BP;vd&ve{+P_GXT5!YS0YlD*<&O#SU-`LEhqz zrdA?J8n;I&{Ddc>kQZC|arC|mr?!^>4xn zoDNGku;=G2o%}1Y?V$tug;Vx!nmCkpuC5X}I$$=Z1nc`){ht zD%(>ebf`WbbHmM-rwf$vSaE?ISVko$#7Isd1`_s^WmpgNupbqy2Eii7g;qTLvh)_Tw#o8EP+VKh2PSMzT@ z_uS`+8ofb`wpc_eeCn7CAkGd6TZNw=cIuh%vtK4vBc!_CcN;QWFdJ>ZUEL$W6*Ao(a&Ajz;VMqa`*dWzL&F28 zDE_lMTa4ewU&Xt9;)mvuENtk*ar@xYYX&XW_j$kApT*3Ek!H%7afxNnXT)6Tq%^0j zXq6qR&rhi8ZiC5&!{AsAHb_QxJ>lPNpl1@ZfeZ5sGoZF!i?|=~u`)Q%9YEciJ|U_^ z1Qy`DwIP=1#IunEY%lc83f%N%nm1SL7H^BAB(P>*-dZ_Wud!^pu!>O1{9YUvzExCt zPh_V~96KR!(zCQ^YIU)MIpuX+c&y9a*v<@}Vkl{Gp{N|%!FpJ=Fz^N_tc=$l@vI=c zygp~ds|+AFfR)s#*Q0b5CSCo_)lFrTwkYAHY%rrm3v~yjW&Wh-8IzuAj9GS2%1B;B zRhuKE}GWolGiq`;}|KE zvg2g3F+T)>Zy6O=x1|dc zAdmzo+$A`{-6as*-QC@tf+Rq2FT8NqLJHU5?oJ`WT>`-)@2$?;r|*5cPxm?Zj_@WBbDUU6OK`qY})wSbxXaMji)1GWwp6LerFkf$dcAS#p1hPRxdBvD<9+l$q@(nMuNrSbdz;)LG z6K#u?(MJ=9fYwzE0k}f2y1C+GzyL(F48j*r{}3WdVyLf`F%zKQd60aaX*TNHpa7}y~ouXGg7_L zZ_YzxH8oms=@iX3_eI6y3*fLYMeK)e2DKm5BtkHcr{VtJ)i?y*%?8Y6FH3SS+1#)*NtJ(!XVD7@xn z_9(M?rL#Z=_dATqGl4wX@9GbCi~!=u1K|1t5;=zAaf^S=)(ckZ4M&g3jC_~ZbTqNk zoAO;=QygY0NEO$>302zAR{!3AC% z%X74b>Vpf45k0=dH8LaGy9=e8Y4hG5r7>IwB<|=xsX&7 zlTs)7yKX)k^hQ|O6{O`#XzFY$Q-bKl#0|ztSJ2$(Xx=cX!(Km3J^urt_3csPLPn|+ zUfrZ?CrpxA`{G$Apv_kgd+%T_HW{I!dN6oGp>Q!;1 za`!r2JB3sr_ndKXFP*kT&K&wA8%a}V)amJ>^AZJNxa_AnFFPBsUVqKTX#>GM#`BN~ zBh`-byWhGd|BOV#KXi1`e;_ElZTc0a9=Ql+Vx+g^?!;Q+$ugdzD%yMpXNJk=IsSZA z*__n00MhIlEVygP8Z0IaJ)vZZu85}`z1F^Hl=XR3t+XXTU2(4)BX5%y zg2m{ za{fms3b}@nG4Uob4IkAH7tET`ZzgdI-aOZ;nlzQ!%Zl8aXj3MLdmjpo@L6@};&+g6 zD$5F!W}A~BV?*YIfvq?M0 zjI%Nc7n&}!ZQhksgkEBn+3t8qNeF#|&a<8`Q9>Io_IDPbXMFxAWnPISZpT&t&bk== zcDq_43=S8H_3JfE{uuRI%#t!+ZO}H8(LUSUjyJBX*826kM=0249*1Pg|7mPGyoF@o zpsFH27e!K8&D>ddMWl|^!+5}5fA(yWR{Po2wAKpT(<;$5`gakim#-QyMQ2)ZEkFhH zI@3_(?KUs?smC_y6eX^+Z?a^g)aSbD7Id^^md3sl3_ZU*77ELX*?C9>&_9^!&YHzl zZz$67`6xNDX9SnFY!NIK*}QQGu=zS3(9*OQA`-H;#s+p5Sxyz^eXf~p1%Y5BL7X5s zG4d`@*5R4-D2>l}H9>r@PBKmycl;flnJ*5|ZetKtJr0lW(xAC4N{al7M^}7u#eu>_ z9^#9gH9_OWHGPa#Uk_$R$VT+j=_M`3-Jk;zHuf|@iu>TwfQS*qD!!%1P~{}}t(of0NdNi^V`qSa0qkeN zKu+XRbKI08qt(cWp^6nwqW8o_N#H{+W0a1zwA90KVQHyTLcESqXIoo!z%Xe*+FX^* zaiv2^P7}V?_wU4+=$VFeZ87Z3d^YhlW$$UrgQsGpuFx~3;t-d7MG+`U*zqeQt=?wg zefag^w#{XUjZ}hwPy(M804$2XW2elK7d1&uY0b4>0KSMUjQm>+@IRx0|NQDz@bX>4 zPOTQ;bK?hmbGj31CO8BCH@oyja|XeyGn(-q%5?NM(Z+XYZd?L5 zz#9@a8w;{?LS+Y*si@cdK+Qtg$;|~Ap`Cf*#8J{W-zFj2z>Ra|d>D~k!|zL#-%r`` zg_Hbc07gN04EOJ`zen+f{@?k6$SD`S>j4YzS~ov@3k$g{oyh2_ziAKjFWyDKtwK@T z_!d6^B;M)iTFyrU35aImOK$vvImpUj-~BooM0o`n-&Dov`hOIete$?a`khYxx6^@R zrm2q!q`#L2B^DR`8C>m~2%w_j@8`i>A)oPSB}nCAt`R$382lY^W4C{nrT!A6{g-0F z|G@dF3H_Rd$1A^QNHuMjl(fXZrd=5H>;FLb8vEf71edqR0rQX{xK3X06`bq@N7*Yb zmA>QF2R{FwqFC5^}bgF>(#OCW`CsO{kBR6hW z!h|>HE?CW%eszn*u%f(_hT@theI_0_$%oLb?#2~2q8;}}RBqT8G@MI)WRpYit|hwb zYRlL<$gOkfwvC1=7r?-x=^>?ZU)$yMJp?*YP>t?ag8NkzZ7BwIo$mPMbsJLIy*Vkh z`b9!@)=evic7BE6EeWSx)TEofU48ur!U|COIQd6U`9MXc{*P)du!fYUrVu~DRee~` z8Vr1Gcyv$JXXI&031dyn@AFAU?LXct_u_@}LJ3<55ll!+BB-H!hqm^7uE<4Yg@Myn zO>F*Lt+;{t-p@vjE!&;htJXag;~fvai-w<>4cn84TcjrI@IDsCol^>YRB16g`E0Q0 z)IBzP&PNsJ)n*&Fa2*>?jXKBPb%AL`U)Lel9&`AeSl{^5xv0ye_5w+yg}s-GF9Dnw zl}P#Zprd6`b6A~RBza(U4;jiYf+_&uBU3oANTXlc9BF;KuSICKK}bRg<72-n{57mZ-F`Ut_oZ`iAt}&@f8dxnlx?N=cxrbv;QeBDzmq<4wkK zhQaIFl*5lNuZ&&lSVQ5^U-f8<)F%4o25#7v1jh0^7vAlS!iG5DD6!#j6tFglAHO=w z!u^c8TaxDJHLl*Zi*px3%r&z8u|Cfl26`3^0k@>CCca-8_Zr8T+(NL~i|t9COZtsG ztuD|m_+ja7+;sez2{Et!qzJES*k#Lng9Pfl1;M>--9{|YIZfS!2Gn8bGmm;#G3vig zIb|k{Jh^uEybttwSFCUWq$S&3>Zex+7Nu$QTfcQy|B=4x-*Do;pL_miYDFu>`se(w zQ3(TTwj`_HsTBpz_s4lwjBHx)mnqx)VUkSs4+Pnt?;a&BdPt#H%H+n9?x%UH(8u?g zhzCngd_wq}0&AILd7ka;spphccpc=|q2CrZ1~1qqR8z@o0w$}wLmTz7>H-m)+d0q^ zhxbgwEu7d-spJQp>%HphduxFPstC$8#og8o-?1s?w^0cPPaTZ4bq)nfiv1~Z*j#uQ z$a!Yf!<I7A zdj#AcTX3o&<&QFuQk}OPRK-6@*NyH^>h7Ae2#Qu9R9!l%I zZRVcZ;R}EpAMi`9{^3ZUDgia$4!8ys((Jq2tp#jv>Hy$!#LjCg74^jAis8*DO;ev7 zdWbweB8d8s;hGjSoa&OzZPjKBOE)AsEs4@kFT=}IMJQu*$S5J_tUfJCT4q^jD2!0G zoyJ9NtQ~+;ymK~}ag7^N*f4-!*=+Sz%P8*}7_YS}fIDb;pR6h0u}Q(^9E^N_Wh|nt z^-Y;YT@?>B;7mjERT0zg#ArfmZUDAc_{e`9^0>2RS5|@=q^dFsmetWv{;6ZQ(K;OF zGOi{e=_?;&?Pj+_#3FaM0@OA5PQQ6^C8bE3tGC?P>TV|#cD3RTZYK{b=sz;COzSSy zX@f7&qBnJ-x@>6Pu^$*_wpwwoNJwD8rg9snc^L?&?oDCCJ{1t)Xv48Cls(ZIK>f3* z@6N>G^XAy2MM{fe;sM{U`pPL7d3LgSrfSTV_ad=W0Z5h+Tf7{ z2<;u4I-~8Jo;=tbAH{xIZGYMPkg-2kW5Z-`nS_l8#~b|bI;el(hXUb#Nc_XxZJA+Q z!XF5syMG`&A^l2+2#p1;$R3XWeBztgs#8|&e$>c>AP_#{kfoo{@{PZJx%xw_#+AWaUQCN+y3(dBvhywu4@QJ+f5C!wXe8 zHa4%R@eO*gYvu(?N@_<&Uwukjbk(QwtW*R$$z*!m23wivny;}tDSTQOSJsv0nTnb! zOGzXnQI4wHhtqM>o{NzyG5Ich>$Bp-Mb3nZEsp`uT5z1}yy`^M<$Sg2i|$hCmOB(Z zVp=3>b?GVx+{>BVwxwm?F;aW2J-&4?&4iNz?SzwPYznZk|8_RvvOC_%3Vd9@8${z4 zrhGoEhCp~zJ#6kabkh2T`CAWKXsEayL5HVr7OdCt_{6Hz-%AQ{J0%2O^oV4dkJ2WP z8y2l~if4BVboSnuR*M?Pw^;gs3bAG}nBKarslWH8IMb3c;Q1Ta#_!K0aOm#?riL6L z#*Z@d+ti03B)bZR3Qucyw{WiO=j~@5DRST}dN#)XZK4I}PUD#{F6#@=Y6o9hm*KY? z34>8EL*0FUU*OZlqgmU(x!VVvWi^m~6&I}(z;vVKBru7G^ zL`?-Mcc)M&M$>_Cf=6#p<;mAaOoq0Cw##gZ)?UiF!pvB;QO9c|Q$Lpw6J zM6-xjjKEEQv-3;{$F&Uq3$>HO_FZ=fw9LsTARs`0Kb%<43M4QN?(Ia?5U}g~rCIkh z_CqYVQ7d_&4cgi&N$iif;bS~TYkj5}*?W~~GiYD*m`n%oU0Jx0+qnPY^A^9L$B`3~ zSul=GzVMkE3J1Kdvh00LnT?9#jr@9)NK1Q`T-$Fd( z`Ny4hp|0F~$WVp5ea1I!rS)p6B@!IzVec^*^?{9zvjv&!b&{mEakv^Z9_$doS1j1~ zW_*NLrF2|9-l@b|X6*%Kv@59orM|k_0ngs^mWh`qZxz1S2hrijmg2a#Ozp0=$Es4m zqV4n3a$l7`L!XWf$02)Be@ciHQiL|#9AV=&|4H$qme%-7PxI6`cju_jYJy?Y>ZXd) zJ{Jy;Kt5fZl9g(U!ct7#P#1SXI6_Nq z7%jA*35GD=6(oxL{-8G18D&)0yn`-$R&#z*SN(I~{EgrGkK#r^4Fut{#}~7Qi3W?t z*&m~z2;sATnS0+aJ6=bh&+@hIEnau!L5BD&u?CGcvTLiHwemw~fZ`Zz-;^&igK&`t z95|JDQ+c&;W)u#w%+emi63E4W5cJ|@HboX-6Egkp7GYvPw|`h=QsDY^{0D+nJ_MUk z4$8j4eHKPX^x10~ikHqbf9`~{aMn$OjxDBdiVq&*X`A9FLoj_?_MUPBHN~Hm4 zxutmY8L_-ORp0pz`(%(gp?a!dM$2fu5h_vtSLbZ=!t%=8%OBebA8o8h6-;ZDTDYKg%e6Z16odN z8pqCt@)Ot-4HVGE>=qOWf%MedyYs(ryrL!>Y7Igp2Vd-aE-nzxCh@@+S`Bd{sci7J zDNTp%iA}{P0!eOzof)B4M2xnON*D``9TVTXsHXGsni_BQq=~q&1NwbRq?8XE%k#5* zPqS5rL{n3XXG;tbyTbhPEOCy8WDB#rQw+*3&nF{yM^2aOuX+v6o63f0dYG9jS}^EQ z=i3L;ur2qpuvFPfZf=z0jF3)F+>P^w7z
sr8WhG{tHr9Tix*qT;M*c-h_c`49j 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 Hx%htoa literal 0 HcmV?d00001 diff --git a/docs/open-source-readiness.md b/docs/open-source-readiness.md index 586b3cc..1d4a7a0 100644 --- a/docs/open-source-readiness.md +++ b/docs/open-source-readiness.md @@ -1,4 +1,42 @@ -# Open-source readiness review +# Open-source readiness and maintenance + +This page separates the **current observed repository state** from the retained 2026-10-24 readiness audit. The [vision](VISION.md), [user guide](USER_GUIDE.md), [documentation map](README.md) and [contribution guide](../CONTRIBUTING.md) describe the current APS project. A public repository and successful deployment do not establish license authority over every imported item, operational safety or a staffed support service. + +## Current observed state — 2026-11-14 + +Authenticated GitHub inspection for `SafetyMP/Agentic-Process-Safety` found the following. These observations are dated; settings may change and should be checked again before a release decision. + +| Area | Observed state | Remaining boundary | +| --- | --- | --- | +| Identity and publication | Public repository, default branch `main`, Apache-2.0 license metadata, canonical [Pages app](https://safetymp.github.io/Agentic-Process-Safety/). | Public visibility is not a legal or safety clearance. | +| Guided experience | [PR #32](https://github.com/SafetyMP/Agentic-Process-Safety/pull/32) deployed as `3ddc4ae9a0dc42c5af98fa7818121cf18a1b364f`; [run 43645203614](https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/43645203614) succeeded. The strict postdeployment gate, 233 hosted Linux checks, 233 live checks, seven capture reviews and nine published-file hash comparisons passed. | This receipt applies to that release, not later source changes. It does not measure learning or operational effectiveness. | +| Community entry points | Issues enabled, Discussions disabled; GitHub community profile reported 100%. | The profile checks file presence, not support quality or response time. Use the issue forms and [support guide](../SUPPORT.md). | +| Security reporting | GitHub private vulnerability reporting enabled. | Enabled intake does not verify staffing, acknowledgement time, or a tested reporting exercise. Follow [SECURITY.md](../SECURITY.md). | +| Secret protection | Secret scanning and push protection enabled. | These are configured protections, not an exhaustive secret-free or history-clean attestation. | +| Dependency maintenance | Version-update configuration exists; Dependabot security updates were disabled at inspection. | Maintainers must assess security-update enablement and review advisories, lockfiles and offline wheels. This refresh does not enable automatic dependency updates or merge them. | +| Code scanning | Latest observed main CodeQL checks passed. | A passing scan has bounded coverage; it does not replace threat review or prove absence of vulnerabilities. | +| GitHub discovery | Homepage points to the app. On 2026-11-14, the description was updated and verified to explain workflow risk, control comparison, causal paths and human recommendations tied to evidence; 17 topics include `assurance` and `human-in-the-loop`. No custom social-preview image was configured at inspection. | These are applied GitHub metadata changes, not publication of this documentation revision. Metadata availability and meaningful descriptions do not guarantee search indexing, ranking or agent retrieval. See [search visibility](SEO.md). | + +## Current owner decisions + +- Confirm rights to project contributions, source data, generated material, screenshots and third-party distributions. Preserve dependency notices and any conflicting legal terms. The original audit's licensing limitations remain applicable. +- Maintain and exercise confidential security intake, establish accountable responders and truthful response expectations, and verify conduct-reporting routes. Do not infer staffing from an enabled GitHub setting. +- Verify current default-branch rulesets, required checks, bypass permissions, Actions permissions and the Pages environment against the actual maintenance workflow. Their complete configuration is not certified by the observations above. +- Assess enabling Dependabot security updates and monitor dependency advisories, including separately bundled wheels. Package publication and supported-version commitments require their own reviewed release process; both npm workspaces remain private. +- Preserve research blinding and exposure records, unverified findings, proposed requirements and pending human risk decisions. Browser discussion-ready status is not a human safety approval. + +## Current validation workflow + +Use `node scripts/verify-repository-readiness.mjs` and `node --test scripts/verify-repository-readiness.test.mjs` for local documentation and community-file checks. Follow [current development checks](DEVELOPMENT_REFERENCE.md#current-development-workflow) for the app, and the source-bound predeployment/postdeployment verifiers for release evidence. Local checks cannot certify remote settings, rights, support staffing or safety suitability. + +New documentation, metadata or discovery assets must be checked as their own revision. The source-bound receipt for PR #32 remains historical once those source bytes change; preserve it rather than relabeling it as evidence for a new release. + +## Historical readiness audit — 2026-10-24 + +The original audit below is retained for provenance. Its initial empty-checkout observations, pending publication statements, stale-manifest failures, then-current test counts and owner checklist describe that earlier work. They are not statements that today's repository lacks Git history, lacks a deployment or still has private reporting disabled. The current observed state above supersedes those time-sensitive descriptions; unresolved rights and safety questions remain unresolved. + +
+Read the original readiness review and reconciliation record Review date: 2026-10-24. Initial local review followed by authenticated remote reconciliation for a draft PR; release remains pending owner decisions. This is a research prototype, not certified industrial software. Hazards remain unverified, controls proposed, and human approvals pending. No remote settings, intellectual-property rights or safety suitability are certified. @@ -86,3 +124,6 @@ Current proposed-tree checks pass: readiness verification, a positive-tree test The full Python unittest discovery also passes on the proposed tree: 108 tests. These are local macOS results, not a claim about Ubuntu CI. The initial workspace Git metadata was backed up privately. Its configured filesystem policy denies writes to the root `.git/config` and `.git/FETCH_HEAD`, so connecting the original workspace remains blocked; the isolated remote-based checkout retains the valid origin/history and proposed branch. No permission escalation or alternate write method was used. The first live PR run passed the Python engine job but the simulator tests failed closed with `policy_unavailable_or_error`: GitHub runners lacked OPA. The new workflow now installs OPA v1.21.4 before those tests, verifies the Linux static binary against the official GitHub release asset SHA-256 `2ab571f367f293bb19523b76f92f1945bbf245003392c7f392903f95c2b9b630`, and adds it to PATH. A mutation case rejects loss of checksum verification. Release metadata was queried directly from `open-policy-agent/opa` via authenticated GitHub API. This prerequisite fix changes only the new readiness workflow, never the pinned deployment or policy gates. + + +
diff --git a/scripts/verify-linux-ci-evidence.mjs b/scripts/verify-linux-ci-evidence.mjs index 1d791e5..ca07bbb 100644 --- a/scripts/verify-linux-ci-evidence.mjs +++ b/scripts/verify-linux-ci-evidence.mjs @@ -10,7 +10,7 @@ process.chdir(fileURLToPath(new URL('../', import.meta.url))); const repository = 'safetymp/agentic-process-safety'; const workflow = '.github/workflows/deploy-pages.yml'; const pins = { - 'apps/aps-demo/scripts/e2e.mjs': '862012eff5b9fefe16e2f3829f453b86885e33ea96f6a18445b3d1fc07812ca8', + 'apps/aps-demo/scripts/e2e.mjs': 'e5858f84a803b2f67fb2c93d30fa7e565a902add418121ad38aafe46eee283ef', 'apps/aps-demo/scripts/qa-evidence.mjs': '859c2a56553c93ad0f6a1e874ced2bfa51dbc1f7a9ec97ba15ba236783f01926', [workflow]: '8a0a0126bfeba484e1b086cf8faecf872847c05146224bc237a1a331c4330e27', }; @@ -46,7 +46,7 @@ export function verifyBrowserResult(result, reviewedAssertions) { equal(result.platform, 'linux', 'Linux browser'); assert.match(result.version, /^\d+\.\d+\.\d+\.\d+$/, 'Actual Chromium version'); equal(result.experience, 'APS guided investigation', 'Reviewed guided investigation experience'); - equal(result.assertions, 233, 'Complete assertion count for the pinned guided investigation runner'); + equal(result.assertions, 257, 'Complete assertion count for the pinned guided investigation runner'); equal(reviewedAssertions, result.assertions, 'Reviewed assertion count'); equal(result.errors, [], 'Console/page errors'); equal(result.violations, [], 'Network violations'); equal(result.prefix, '/agentic-process-safety/', 'Pages base path'); equal(result.screenshots, captures, 'Seven capture calls'); diff --git a/scripts/verify-linux-ci-evidence.test.mjs b/scripts/verify-linux-ci-evidence.test.mjs index 3ace388..a7bcb2f 100644 --- a/scripts/verify-linux-ci-evidence.test.mjs +++ b/scripts/verify-linux-ci-evidence.test.mjs @@ -8,10 +8,10 @@ import { evidenceEntries, gitBlobSha, verifyBrowserResult, verifyNodeVersion } f // Synthetic unit fixtures test parsing and rejection, never actual CI provenance. const result = () => ({ status: 'passed', platform: 'linux', engine: 'chromium', version: '140.0.7339.0', - assertions: 233, experience: 'APS guided investigation', errors: [], violations: [], prefix: '/agentic-process-safety/', + assertions: 257, experience: 'APS guided investigation', errors: [], violations: [], prefix: '/agentic-process-safety/', screenshots: ['overview', 'hazop', 'governance', 'simulator', 'assurance', 'mobile-light', 'mobile-dark'].map(n => `docs/screenshots/${n}.jpg`), }); -test('accepts a correctly formatted complete browser result', () => verifyBrowserResult(result(), 233)); +test('accepts a correctly formatted complete browser result', () => verifyBrowserResult(result(), 257)); test('accepts actual Node 22 version format', () => verifyNodeVersion('v22.23.2')); test('rejects other Node major and literal backslash escape', () => { for (const version of ['v20.23.2', 'v220.1.0', 'v22\\.23.2']) assert.throws(() => verifyNodeVersion(version)); @@ -30,18 +30,18 @@ test('Git blob header uses byte length and NUL exactly as Git does', () => { for (const [name, patch] of Object.entries({ failed: { status: 'failed' }, macOS: { platform: 'darwin' }, firefox: { engine: 'firefox' }, version: { version: '' }, escapedVersion: { version: '140\\.0\\.7339\\.0' }, - malformedVersion: { version: '140x0x7339x0' }, partial: { assertions: 232 }, legacyCount: { assertions: 137 }, inflatedCount: { assertions: 234 }, fractional: { assertions: 233.5 }, priorRedesignCount: { assertions: 185 }, + malformedVersion: { version: '140x0x7339x0' }, partial: { assertions: 256 }, legacyCount: { assertions: 137 }, inflatedCount: { assertions: 258 }, fractional: { assertions: 257.5 }, priorRedesignCount: { assertions: 185 }, priorGuidedCount: { assertions: 233 }, missingExperience: { experience: undefined }, legacyExperience: { experience: 'Legacy app' }, previousRedesign: { experience: 'APS redesign increments 1–4' }, console: { errors: ['console error'] }, network: { violations: ['external request'] }, basePath: { prefix: '/' }, missingCaptures: { screenshots: [] }, -})) test(`rejects ${name} browser evidence`, () => assert.throws(() => verifyBrowserResult({ ...result(), ...patch }, 233))); +})) test(`rejects ${name} browser evidence`, () => assert.throws(() => verifyBrowserResult({ ...result(), ...patch }, 257))); test('rejects differing reviewed assertion count', () => assert.throws(() => verifyBrowserResult(result(), 139))); -test('rejects absent result', () => assert.throws(() => verifyBrowserResult(undefined, 233))); +test('rejects absent result', () => assert.throws(() => verifyBrowserResult(undefined, 257))); test('postdeployment pin migration accepts only exact reviewed e2e/Pages bytes', () => { const source = readFileSync(new URL('./verify-linux-ci-evidence.mjs', import.meta.url), 'utf8'); - const exact = ['862012eff5b9fefe16e2f3829f453b86885e33ea96f6a18445b3d1fc07812ca8', '8a0a0126bfeba484e1b086cf8faecf872847c05146224bc237a1a331c4330e27', '859c2a56553c93ad0f6a1e874ced2bfa51dbc1f7a9ec97ba15ba236783f01926']; - const stale = ['09f3ac4c7637988c34b1422df07724a8a84c3096b7a46129e775e7b2d3e3316b', 'b8a854c2f40421d0d71f635a21e27e971294c0633cf43079934edec123395684', '6086f2d7c5f8956d11b1cc04777f3ed527b80a2c96b87b728b3d31728bdaace2', '2725d66974b527c775f377dd2a4409bfc47658b6702cbc14b6ec1b5be9db8215']; + const exact = ['e5858f84a803b2f67fb2c93d30fa7e565a902add418121ad38aafe46eee283ef', '8a0a0126bfeba484e1b086cf8faecf872847c05146224bc237a1a331c4330e27', '859c2a56553c93ad0f6a1e874ced2bfa51dbc1f7a9ec97ba15ba236783f01926']; + const stale = ['862012eff5b9fefe16e2f3829f453b86885e33ea96f6a18445b3d1fc07812ca8', '09f3ac4c7637988c34b1422df07724a8a84c3096b7a46129e775e7b2d3e3316b', 'b8a854c2f40421d0d71f635a21e27e971294c0633cf43079934edec123395684', '6086f2d7c5f8956d11b1cc04777f3ed527b80a2c96b87b728b3d31728bdaace2', '2725d66974b527c775f377dd2a4409bfc47658b6702cbc14b6ec1b5be9db8215']; const literalPins = [...source.matchAll(/: '([a-f0-9]{64})'/g)].map(match => match[1]); assert.deepEqual(literalPins.sort(), [...exact].sort()); const currentPaths = ['apps/aps-demo/scripts/e2e.mjs', '.github/workflows/deploy-pages.yml', 'apps/aps-demo/scripts/qa-evidence.mjs']; diff --git a/scripts/verify-linux-predeploy-evidence.mjs b/scripts/verify-linux-predeploy-evidence.mjs index 85015ef..1b2c452 100644 --- a/scripts/verify-linux-predeploy-evidence.mjs +++ b/scripts/verify-linux-predeploy-evidence.mjs @@ -10,15 +10,15 @@ import { fileURLToPath } from 'node:url'; export const BOUNDS = Object.freeze({ archive: 64 * 1024 * 1024, expanded: 128 * 1024 * 1024, entry: 16 * 1024 * 1024, entries: 512, json: 2 * 1024 * 1024, source: 1000, dist: 128, depth: 20, nodes: 20000 }); export const REPOSITORY = 'safetymp/agentic-process-safety'; export const WORKFLOW = '.github/workflows/repository-checks.yml'; -export const RELEASE_HEAD_REFS = Object.freeze(['release/aps-github-validation-v1', 'codex/aps-redesign-release', 'codex/aps-guided-investigation']); +export const RELEASE_HEAD_REFS = Object.freeze(['release/aps-github-validation-v1', 'codex/aps-redesign-release', 'codex/aps-guided-investigation', 'codex/aps-repository-alignment']); export const CAPTURES = Object.freeze(['overview', 'hazop', 'governance', 'simulator', 'assurance', 'mobile-light', 'mobile-dark'].map(n => `docs/screenshots/${n}.jpg`)); // These expectations are reviewed source policy, never supplied by an artifact. export const PINS = Object.freeze({ - [WORKFLOW]: '57f83716af8db23a02624fadfd86d51f0cc973cef45aa8aa7c886eba34e4109d', + [WORKFLOW]: 'f0d4c671411929cfc0d9a8f5512f8791c65fbaea8bb3bca0545d624ac8483c7c', '.github/workflows/deploy-pages.yml': '8a0a0126bfeba484e1b086cf8faecf872847c05146224bc237a1a331c4330e27', - 'apps/aps-demo/scripts/e2e.mjs': '862012eff5b9fefe16e2f3829f453b86885e33ea96f6a18445b3d1fc07812ca8', + 'apps/aps-demo/scripts/e2e.mjs': 'e5858f84a803b2f67fb2c93d30fa7e565a902add418121ad38aafe46eee283ef', 'apps/aps-demo/scripts/qa-evidence.mjs': '859c2a56553c93ad0f6a1e874ced2bfa51dbc1f7a9ec97ba15ba236783f01926', - 'apps/aps-demo/scripts/validation-evidence.mjs': '0c1474e3f899626586372476ddf4911dc3bf25e75c3620b01d88e7362fcd92c2', + 'apps/aps-demo/scripts/validation-evidence.mjs': 'ad2e1b879515eeecef0b90e6cc9a3b4c93400070bc9e9bc6186a61421871ee69', 'package-lock.json': '6350fea042ab97510b73aa1969e2469731753b5f95814caafa7f8d0ecbe7d303', }); export const hash = bytes => createHash('sha256').update(bytes).digest('hex'); diff --git a/scripts/verify-linux-predeploy-evidence.test.mjs b/scripts/verify-linux-predeploy-evidence.test.mjs index ea49a70..72905bc 100644 --- a/scripts/verify-linux-predeploy-evidence.test.mjs +++ b/scripts/verify-linux-predeploy-evidence.test.mjs @@ -35,12 +35,12 @@ function fixture() { const sourceDigest = hash(JSON.stringify(source)); const distDigest = hash(JSON.stringify(dist)); const runId = 123; const runAttempt = 2; const artifactId = 456; const runUrl = 'https://github.com/SafetyMP/Agentic-Process-Safety/actions/runs/123/attempts/2'; - const browser = { status: 'passed', platform: 'linux', engine: 'chromium', version: '140.0.7339.0', assertions: 233, errors: [], violations: [], prefix: '/agentic-process-safety/', screenshots: [...CAPTURES], experience: 'APS guided investigation' }; + const browser = { status: 'passed', platform: 'linux', engine: 'chromium', version: '140.0.7339.0', assertions: 257, errors: [], violations: [], prefix: '/agentic-process-safety/', screenshots: [...CAPTURES], experience: 'APS guided investigation' }; const images = new Map(CAPTURES.map((path, i) => [path, Buffer.concat([Buffer.from([0xff, 0xd8]), Buffer.alloc(1100, i), Buffer.from([0xff, 0xd9])])])); const review = { schema: 'aps-linux-predeploy-review-1', repository: REPOSITORY, repositoryId: 1430231911, pullRequest: 73, headSha: head, baseSha: base, checkoutSha: checkout, checkoutTree: tree, workflowSha: checkout, workflowBlob, workflowRef, - runId, runAttempt, artifactId, runUrl, reviewer: 'Synthetic unit reviewer', reviewedAt: '2026-10-25T20:00:00Z', limitations: 'Synthetic unit fixture; no browser or CI run occurred.', assertions: 233, + runId, runAttempt, artifactId, runUrl, reviewer: 'Synthetic unit reviewer', reviewedAt: '2026-10-25T20:00:00Z', limitations: 'Synthetic unit fixture; no browser or CI run occurred.', assertions: 257, nodeVersion: 'v22.23.2', browserVersion: browser.version, sourceDigest, distDigest, screenshots: Object.fromEntries([...images].map(([path, image]) => [path, { sha256: hash(image), accepted: true, observations: `Synthetic fixture ${path}; not a real visual review.` }])), }; @@ -78,6 +78,18 @@ function fixture() { test('accepts only a complete synthetic PR evidence chain, disclosing no deployment', async () => { assert.match(await verifyPredeploy(fixture().build()), /^Predeployment validation only; no deployment attested\./); }); +test('workflow, observer and verifier retain only the four exact reviewed release branches', async () => { + const expected = ['release/aps-github-validation-v1', 'codex/aps-redesign-release', 'codex/aps-guided-investigation', 'codex/aps-repository-alignment']; + assert.deepEqual(RELEASE_HEAD_REFS, expected); + const observer = await readFile(new URL('apps/aps-demo/scripts/validation-evidence.mjs', root), 'utf8'); + const declaration = /const releaseHeadRefs = Object\.freeze\(\[(.*?)\]\)/.exec(observer); + assert.ok(declaration, 'Observer exact allowlist declaration'); + assert.deepEqual([...declaration[1].matchAll(/'([^']+)'/g)].map(match => match[1]), expected); + const workflow = content.get(WORKFLOW).toString(); + const guards = workflow.split('\n').filter(line => line.includes('github.event.pull_request.head.ref ==')); + assert.equal(guards.length, 3, 'All three predeployment steps retain branch guards'); + for (const guard of guards) assert.deepEqual([...guard.matchAll(/github\.event\.pull_request\.head\.ref == '([^']+)'/g)].map(match => match[1]), expected); +}); for (const branch of RELEASE_HEAD_REFS) test(`accepts the exact authorized branch ${branch} with matching PR/run/observation`, async () => { const f = fixture(); f.metadata.get('/pulls/73').head.ref = branch; @@ -122,6 +134,10 @@ const mutations = { 'wrong head ref': f => { f.metadata.get('/pulls/73').head.ref = 'other'; }, 'unreviewed branch resembling authorized redesign': f => { f.metadata.get('/pulls/73').head.ref = 'codex/aps-redesign-release-extra'; }, 'unreviewed branch resembling guided investigation': f => { f.metadata.get('/pulls/73').head.ref = 'codex/aps-guided-investigation-extra'; }, + 'unreviewed branch resembling repository alignment': f => { f.metadata.get('/pulls/73').head.ref = 'codex/aps-repository-alignment-extra'; }, + 'case-changed repository alignment branch': f => { f.metadata.get('/pulls/73').head.ref = 'codex/APS-repository-alignment'; }, + 'alignment run branch substituted for a different allowed PR': f => { f.metadata.get('/actions/runs/123/attempts/2').head_branch = 'codex/aps-repository-alignment'; }, + 'alignment observed branch substituted for a different allowed PR': f => { f.observed.pullRequest.head.ref = 'codex/aps-repository-alignment'; }, 'guided run branch substituted for a different allowed PR': f => { f.metadata.get('/actions/runs/123/attempts/2').head_branch = 'codex/aps-guided-investigation'; }, 'guided observed branch substituted for a different allowed PR': f => { f.observed.pullRequest.head.ref = 'codex/aps-guided-investigation'; }, 'prior redesign experience substituted for guided investigation': f => { f.browser.experience = 'APS redesign increments 1–4'; }, diff --git a/scripts/verify-repository-readiness.mjs b/scripts/verify-repository-readiness.mjs index 69b8a29..b585b90 100644 --- a/scripts/verify-repository-readiness.mjs +++ b/scripts/verify-repository-readiness.mjs @@ -1,8 +1,14 @@ -import { readFileSync, existsSync } from 'node:fs'; +import { readFileSync, readdirSync, existsSync } from 'node:fs'; import { resolve, dirname } from 'node:path'; import { fileURLToPath } from 'node:url'; -export const documents = ['README.md', 'CONTRIBUTING.md', 'CODE_OF_CONDUCT.md', 'SECURITY.md', 'SUPPORT.md', 'docs/open-source-readiness.md', '.github/PULL_REQUEST_TEMPLATE.md']; +export const documents = [ + 'README.md', 'AGENTS.md', 'CONTRIBUTING.md', 'CODE_OF_CONDUCT.md', 'SECURITY.md', 'SUPPORT.md', + 'docs/README.md', 'docs/VISION.md', 'docs/USER_GUIDE.md', 'docs/SEO.md', 'docs/assets/README.md', + 'docs/DEVELOPMENT_REFERENCE.md', 'docs/ARCHITECTURE.md', 'docs/METHODOLOGY.md', + 'docs/GOVERNANCE_ARCHITECTURE.md', 'docs/THREAT_MODEL.md', 'docs/open-source-readiness.md', + 'apps/aps-demo/src/domain/README.md', '.github/PULL_REQUEST_TEMPLATE.md', +]; export function verify(root) { const errors = []; const read = p => { try { return readFileSync(resolve(root, p), 'utf8'); } catch { errors.push('Missing file: ' + p); return ''; } }; @@ -21,6 +27,24 @@ export function verify(root) { } } } + const index = read('docs/README.md'); + const indexed = new Set([...index.matchAll(/\[[^\]\n]+\]\(([^)\s]+)\)/g)] + .map(match => match[1].split('#')[0]).filter(path => path && !/^(https?:|mailto:)/.test(path)) + .map(path => resolve(root, 'docs', decodeURIComponent(path)))); + function checkIndex(directory) { + if (!existsSync(resolve(root, directory))) return; + for (const item of readdirSync(resolve(root, directory), { withFileTypes: true })) { + const path = directory + '/' + item.name; + if (path === 'docs/screenshots') continue; // Generated release captures are not documentation. + if (item.isDirectory()) checkIndex(path); + else if (item.isFile() && /\.(?:md|json|jpg)$/i.test(item.name) && !indexed.has(resolve(root, path))) errors.push('Documentation missing from index: ' + path); + } + } + checkIndex('docs'); + const citation = read('CITATION.cff'); + for (const marker of ['cff-version: 1.2.0', 'type: software', 'title:', 'authors:', 'repository-code:', 'license: Apache-2.0']) { + if (!citation.includes(marker)) errors.push('Missing citation field: ' + marker); + } const license = read('LICENSE'); for (const marker of ['Version 2.0, January 2004', '1. Definitions.', '9. Accepting Warranty or Additional Liability.', 'END OF TERMS AND CONDITIONS', 'APPENDIX: How to apply the Apache License']) { if (!license.includes(marker)) errors.push('Incomplete Apache license: ' + marker); @@ -32,7 +56,7 @@ export function verify(root) { if (pkg.license !== 'Apache-2.0' || lock.packages?.[p]?.license !== pkg.license) errors.push('License metadata mismatch: ' + p); if (pkg.private !== true) errors.push('Unexpected package publication enabled: ' + p); } - for (const p of ['bug', 'question']) { + for (const p of ['bug', 'question', 'proposal']) { const form = read('.github/ISSUE_TEMPLATE/' + p + '.yml'); for (const pattern of [/^name: .+/m, /^description: .+/m, /^body:/m, /type: textarea/, /required: true/]) if (!pattern.test(form)) errors.push('Invalid issue form: ' + p); } diff --git a/scripts/verify-repository-readiness.test.mjs b/scripts/verify-repository-readiness.test.mjs index acb941a..42b7aa4 100644 --- a/scripts/verify-repository-readiness.test.mjs +++ b/scripts/verify-repository-readiness.test.mjs @@ -11,7 +11,7 @@ test('the proposed repository passes readiness checks', () => { test('negative cases reject broken links, privilege escalation, unpinned actions and metadata drift', () => { const base = resolve(root, '.harness/tmp'); mkdirSync(base, { recursive: true }); const dir = mkdtempSync(resolve(base, 'readiness-test-')); - const files = [...documents, 'LICENSE', 'package.json', 'package-lock.json', 'apps/aps-demo/package.json', '.github/ISSUE_TEMPLATE/bug.yml', '.github/ISSUE_TEMPLATE/question.yml', '.github/dependabot.yml', '.github/workflows/repository-checks.yml']; + const files = [...documents, 'CITATION.cff', 'LICENSE', 'package.json', 'package-lock.json', 'apps/aps-demo/package.json', '.github/ISSUE_TEMPLATE/bug.yml', '.github/ISSUE_TEMPLATE/question.yml', '.github/ISSUE_TEMPLATE/proposal.yml', '.github/dependabot.yml', '.github/workflows/repository-checks.yml']; try { for (const p of files) { mkdirSync(dirname(resolve(dir, p)), { recursive: true }); copyFileSync(resolve(root, p), resolve(dir, p)); } // Other existing README links are absent in this minimal fixture; test targeted diagnostics. @@ -22,6 +22,12 @@ test('negative cases reject broken links, privilege escalation, unpinned actions writeFileSync(target, original); }; mutate('CONTRIBUTING.md', s => s + '\n[missing](missing-file.md)\n', 'Broken local link in CONTRIBUTING.md'); + mutate('AGENTS.md', s => s + '\n[missing](docs/UNKNOWN.md)\n', 'Broken local link in AGENTS.md'); + mutate('docs/USER_GUIDE.md', s => s + '\n[missing section](VISION.md#unknown-section)\n', 'Broken anchor in docs/USER_GUIDE.md'); + mutate('CITATION.cff', s => s.replace('authors:', 'omitted:'), 'Missing citation field: authors:'); + writeFileSync(resolve(dir, 'docs/UNLISTED.md'), '# Unlisted guide\n'); + assert.ok(verify(dir).includes('Documentation missing from index: docs/UNLISTED.md')); + rmSync(resolve(dir, 'docs/UNLISTED.md')); mutate('.github/workflows/repository-checks.yml', s => s.replace('contents: read', 'contents: write'), 'Unsafe CI'); mutate('.github/workflows/repository-checks.yml', s => s.replace('node --test apps/aps-demo/scripts/production.test.mjs', 'echo skipped'), 'Missing CI guard/check: node --test apps/aps-demo/scripts/production.test.mjs'); mutate('.github/workflows/repository-checks.yml', s => s.replace(/checkout@[a-f0-9]{40}/g, 'checkout@main'), 'Unpinned action');