https://github.com/mizcausevic-dev/permit-package-readiness-hub
TypeScript control plane for permit packages, readiness blockers, inspection posture, and construction-safe submission operations.
https://github.com/mizcausevic-dev/permit-package-readiness-hub
b2b-saas construction-tech control-plane field-operations kinetic-gain permitting revops typescript workflow-automation
Last synced: 1 day ago
JSON representation
TypeScript control plane for permit packages, readiness blockers, inspection posture, and construction-safe submission operations.
- Host: GitHub
- URL: https://github.com/mizcausevic-dev/permit-package-readiness-hub
- Owner: mizcausevic-dev
- License: agpl-3.0
- Created: 2026-05-25T21:56:32.000Z (7 days ago)
- Default Branch: main
- Last Pushed: 2026-05-25T23:07:00.000Z (7 days ago)
- Last Synced: 2026-05-26T00:14:01.933Z (7 days ago)
- Topics: b2b-saas, construction-tech, control-plane, field-operations, kinetic-gain, permitting, revops, typescript, workflow-automation
- Language: TypeScript
- Homepage: https://permits.kineticgain.com/
- Size: 320 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Permit Package Readiness Hub
[](https://github.com/mizcausevic-dev/permit-package-readiness-hub/actions/workflows/ci.yml)
[](./LICENSE)
[](./.github/dependabot.yml)
[](https://github.com/mizcausevic-dev/permit-package-readiness-hub/actions/workflows/pages.yml)
TypeScript control plane for permit packages, readiness blockers, inspection posture, and construction-safe submission operations.
## Why this exists
- Construction teams lose schedule trust when revision parity, utility sign-off, and inspection packets drift in different places at different speeds.
- Permit readiness needs a clear view of which packages are live, which blockers still need proof, and which inspection-facing packets should not move yet.
- Construction Tech buyers care whether submittal and inspection operations can stay safe without fragmenting PM, field, and jurisdiction-facing workflows.
- Operators want tooling that turns permit chaos into governed package lanes, named ownership, and measurable submission posture.
## Why this matters (KG Embedded tie-back)
This repo demonstrates the permit-readiness primitive for Construction Tech buyers: packages, blockers, and inspection-facing posture tied into one operator surface. A B2B SaaS buyer would care because permit, field, and readiness data often need to surface inside customer-facing products without exposing unsafe write paths or fragmented operational evidence. Kinetic Gain Embedded extends this into security-first in-product analytics for permit readiness, inspection cadence, and field workflows, see [kineticgain.com/embedded](https://kineticgain.com/embedded).
## Routes
- `/`
- `/permit-lane`
- `/readiness-risks`
- `/inspection-posture`
- `/verification`
- `/docs`
## API
- `/api/dashboard/summary`
- `/api/permit-lane`
- `/api/readiness-risks`
- `/api/inspection-posture`
- `/api/verification`
- `/api/sample`
## Screenshots
## Local Development
```powershell
cd permit-package-readiness-hub
npm install
npm run dev
```
Open:
- [http://127.0.0.1:5550/](http://127.0.0.1:5550/)
- [http://127.0.0.1:5550/permit-lane](http://127.0.0.1:5550/permit-lane)
- [http://127.0.0.1:5550/readiness-risks](http://127.0.0.1:5550/readiness-risks)
- [http://127.0.0.1:5550/inspection-posture](http://127.0.0.1:5550/inspection-posture)
- [http://127.0.0.1:5550/verification](http://127.0.0.1:5550/verification)
## Validation
- `npm run build`
- `npm run test`
- `npm run coverage`
- `npm run demo`
- `npm run smoke`
- `npm run prerender`
- `npm run render:assets`
## Production status
| Aspect | Status |
|--------|--------|
| CI | Node 20 + 22 matrix — lint · typecheck · coverage · build · demo · smoke · `npm audit` ([workflow](./.github/workflows/ci.yml)) |
| Test coverage | 100% statements on `src/services/` (gate: ≥ 60%) |
| License | [AGPL-3.0-or-later](./LICENSE) |
| Dependencies | Dependabot weekly (npm + GitHub Actions); `npm audit --audit-level=high` in CI |
| Security | [SECURITY.md](./SECURITY.md) — 0 known high/critical advisories at v1.0-prod |
| Deploy | Static prerender → **https://permits.kineticgain.com/** (GitHub Pages, [pages workflow](./.github/workflows/pages.yml)) |
## Docs
- [Architecture](./docs/architecture.md)
- [Origin](./docs/ORIGIN.md)
- [Kinetic Gain Embedded tie-back](./docs/KINETIC_GAIN_EMBEDDED.md)
- [Changelog](./CHANGELOG.md)
## Part of the Kinetic Gain Suite
Operator surface in the [Kinetic Gain Suite](https://suite.kineticgain.com/) — a portfolio of buyer-readable control planes spanning security posture, compliance evidence, data-platform governance, FinOps, and operator workflows. See the suite index for related surfaces. Apex: [kineticgain.com](https://kineticgain.com/).