Morris PeopleSoft Utilities

Morris PeopleSoft Utilities (MPU) is a modern Manifest V3 Chrome extension that helps college business analysts and technical staff work faster in PeopleSoft Classic and Fluid—with privacy-first defaults and AODA-oriented accessibility.

Maintained by hackmods (Ryan Morris).

Why MPU?

Classic PS Utilities improved PeopleSoft usability but aged out of Chrome Web Store and Fluid expectations. MPU is a greenfield TypeScript rewrite aimed at an official Chrome Web Store listing: equal feature access for BA and technical users, no credential storage, no telemetry, and documented compliance controls (including an opt-in host allowlist).

Features

Business analysts	Technical staff
Environment labels	PeopleCode / SQL trace toggle
Favorites with CSV import/export	Field Inspector (Classic, Fluid, Classic-in-Fluid)
Page information + upgrade watch	New window / deep links / Admin jumps
Field Entry (bulk paste / multi-row grids)	Trace profiles + PCode stubs
Advanced Search & Correct History helpers	Settings JSON backup
Quiet mode for env prompts

Install

Chrome Web Store (recommended)

Store listing is in progress. When you are ready to submit:

• store/PUBLISH.md — start here (publish checklist)
• store/DEVELOPER_DASHBOARD.md — step-by-step upload guide
• docs/release-readiness.md — blocking vs nice-to-have
• store/SUBMISSION_CHECKLIST.md — dashboard checklist

When published, this section will link the Store URL.

Load unpacked (developers)

npm ci
npm run generate:icons
npm run build

1. Open chrome://extensions
2. Enable Developer mode
3. Load unpacked → select the dist/ folder

Or download the latest zip from GitHub Releases.

Privacy

• Settings stay in chrome.storage.local on your device
• No passwords, no analytics, no developer phone-home
• Full policy: docs/privacy.md

Accessibility (AODA)

MPU targets WCAG 2.1 Level AA for extension UI and the injected utilities bar. Details: docs/aoda.md.

Screenshots

Listing images (1280×800) live under store/assets/screenshots/. Import live PeopleSoft captures with store/incoming/ and npm run import:store-screenshots.

Utilities bar	Field Inspector	Options

Replace mocks with your Classic/Fluid captures before the public Store listing (npm run audit:store warns while mocks remain).

Testing

Automated gates run locally and in CI:

Command	What it covers
npm test	Unit, integration, smoke, and a11y Vitest suites
npm run test:coverage	Same + V8 coverage (thresholds enforced)
npm run test:a11y	axe WCAG 2A/2AA on popup/options markup
npm run audit	a11y + Store lint + compliance scan
npm run test:all	lint + coverage + audits + production build
npm run release:check	Full release gate (lint, coverage, audits, zip)

Suites:

• tests/unit — URL/adapters, storage, bar, field inspector, trace, search, injects
• tests/integration — BA session bootstrap + audit script execution
• tests/a11y — axe accessibility
• tests/smoke — repo/Store prerequisites and built dist/ checks

Details: docs/testing/automated.md
Manual PeopleSoft parity: docs/testing/manual-parity-checklist.md

Development

npm ci
npm run generate:icons
npm run generate:store-assets
npm run lint
npm run test:coverage
npm run audit
npm run build
npm run import:store-screenshots  # live CWS screenshots from store/incoming/
npm run prep:store                # audit + extension zip for dashboard upload

See the wiki sources and CONTRIBUTING.md.

PeopleSoft agent prompt pack

Separate from the extension itself — nothing under agents/ ships in the Chrome zip:

• Browse: agents/ · guide agents/README.md · wiki AI agent prompts
• Download: each GitHub Release attaches morris-peoplesoft-agents-v*.zip (or run npm run package:agents)

Covers PeopleTools 8.5x–8.6x / PS 8.56: data & PeopleCode review, SQL authoring, IB/CI integrations, MCP schema assist, design, onboarding, and specialist training — for Cursor, Visual Studio / VS Code + Copilot, or Claude.

Releases

Tagged versions (v*) publish the Chrome Web Store zip and the agents prompt zip via GitHub Actions. Prefer installing the extension from the Store once live; use Release artifacts for review builds.

Latest: tag v1.0.26 after merge, or run npm run prep:store for a local upload zip. Previous: v1.0.25.

Credits

• Maintainer / publisher: hackmods (Ryan Morris)
• Inspired by: PS Utilities — original work by Uffe Graakjaer, Neil Yetman, and contributors. MPU is a separate greenfield project; legacy sources under .reference/ are a local behavior oracle and are not shipped in the extension package.

License

MIT