jamminrebel/pom-omp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: canonical URLs now live (self-hosted Gitea + wiki.pom.loca.zone)

Browse Source
This commit is contained in:
Antigravity
2026-08-19 11:08:38 +02:00
parent 1c7b113e99
commit 971e89e600
5 changed files with 54 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

84
README.md
View File

@@ -41,12 +41,18 @@ Step 1 — obtain the repository source. Canonical project coordinates are recor
| Field | Value | State |
|---|---|---|
| `homepage` | `https://wiki.omp.loca.zone/` | Live |
| `bugs.url` | `https://wiki.omp.loca.zone/` | Live |
| `homepage` | `https://wiki.pom.loca.zone/` | Live |
| `bugs.url` | `https://wiki.pom.loca.zone/` | Live |
| `bugs.email` | `antigravity@loca.zone` | Live |
| `repository.url` | `git+https://omp.loca.zone/pom-omp.git` | Reserved — not yet serving Git |
| `repository.url` | `git+https://git.omp.loca.zone/jamminrebel/pom-omp.git` | Live — self-hosted Gitea, anonymous clone |
There is deliberately no public forge mirror: this package has never been published to npm, and no GitHub or self-hosted Git endpoint exists for it today. Until `repository.url` is actually served, obtain the checkout out of band from the maintainer. Do not substitute a third-party URL that has not been confirmed.
There is deliberately no public forge mirror and this package has never been published to npm. Clone from the owned endpoint:
```bash
git clone https://git.omp.loca.zone/jamminrebel/pom-omp.git
```
Do not substitute a third-party URL that has not been confirmed.
Step 2 — install, verify, and link from the checkout root:
@@ -56,7 +62,7 @@ npm run verify
npm run link
```
`npm run verify` does not currently complete in this environment. See [Verification status](#verification-status) before treating a failure as a code defect.
`npm run verify` completes green from a clean `npm install` on this host. See [Verification status](#verification-status) for the recorded gate evidence.
Step 3 — restart OMP or run `/reload-plugins`, then install the bundled themes:
@@ -80,47 +86,37 @@ Precondition: the tarball must contain `prompts/`. `src/prompts.ts` resolves bun
### Verification status
Overall readiness: PARTIAL.
Overall readiness: GREEN for the six repository-local gates; four host-dependent gates remain NOT RUN.
Currently passing:
`npm run verify` exits 0 from a clean `npm install` on this host. Each gate below is recorded as evidence under `00_admin/validation/` and rendered into `RELEASE.json` by `scripts/release-manifest.mjs`; a missing evidence file renders NOT RUN, and `passed !== true` renders FAIL.
| Check | Command |
| Gate | Command | State |
|---|---|---|
| TypeScript | `npm run check` | PASS |
| Behavioral tests | `npm test` | PASS |
| Runtime smoke | `npm run smoke` | PASS |
| Structural verification | `node scripts/verify.mjs` | PASS |
| Theme schema | asserted inside `scripts/verify.mjs` | PASS |
| Pack dry run | `npm run pack:dry` | PASS |
| Production dependency audit | `npm audit --omit=dev` | NOT RUN |
| Full development tree audit | `npm audit` | NOT RUN |
| OMP plugin doctor | `npm run doctor` | NOT RUN — requires Bun plus an installed OMP host |
| Interactive TUI smoke | manual OMP session | NOT RUN — requires an interactive terminal |
Never satisfy a gate with a stub: do not vendor dependencies into the repository, and do not hand-write or copy the OMP SDK packages or the OMP theme schema. A gate satisfied by a stub proves nothing about the shipped extension.
Dependency requirements per check:
| Check | Needs installed dependencies |
|---|---|
| Extension smoke test | `npm run smoke` |
| Release manifest parity | `npm run release:check` |
| State unit tests | `node --import tsx --test tests/state.test.ts` |
The full gate is BLOCKED, not passing. `npm run verify` cannot complete because an npm registry outage (repeated `ETIMEDOUT` on install) left `node_modules` incomplete. Missing at minimum:
| Missing | Blocks |
|---|---|
| `@oh-my-pi/pi-coding-agent`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-utils` | `npm run check`, every test importing `src/` modules that reference the OMP SDK |
| `@types/node` | `npm run check` (`tsc --noEmit`) |
| `yauzl` | `tests/zip.test.ts` and the archive verification path in `src/zip.ts` |
| `node_modules/@oh-my-pi/pi-coding-agent/src/modes/theme/theme-schema.json` | `node scripts/verify.mjs` theme validation |
No claim is made that `npm run verify` has passed in this environment.
### Registry outage and offline guidance
Rules while the registry is unreachable:
- Do not vendor dependencies into the repository.
- Do not stub, hand-write, or copy the OMP SDK packages or the OMP theme schema to turn a gate green. A gate satisfied by a stub proves nothing about the shipped extension.
- Repair or retry registry access, rerun `npm install`, then rerun the full `npm run verify` gate and record its real result.
What each check needs:
| Check | Offline without installed dependencies |
|---|---|
| `npm run smoke` | Meaningful — runs through `tsx` against `src/` without resolving the OMP SDK at runtime |
| `npm run release:check` | Meaningful — `scripts/release-manifest.mjs` uses Node builtins only |
| `node --import tsx --test tests/state.test.ts` | Meaningful — exercises state logic only |
| `npm run check` | Requires installed dependencies (OMP SDK type declarations plus `@types/node`) |
| `npm test` (full suite) | Requires installed dependencies (`yauzl`, `yazl`, OMP SDK) |
| `node scripts/verify.mjs` | Requires installed dependencies (reads the OMP theme schema from `node_modules`) |
| `npm run pack:dry` | Requires a resolvable npm environment |
| `npm run doctor` | Requires Bun plus an installed OMP host |
| `npm run smoke` | No — runs through `tsx` against `src/` without resolving the OMP SDK at runtime |
| `npm run release:check` | No — `scripts/release-manifest.mjs` uses Node builtins only |
| `node --import tsx --test tests/state.test.ts` | No — exercises state logic only |
| `npm run check` | Yes — OMP SDK type declarations plus `@types/node` |
| `npm test` (full suite) | Yes — `yauzl`, `yazl`, OMP SDK |
| `node scripts/verify.mjs` | Yes — reads the OMP theme schema from `node_modules` |
| `npm run pack:dry` | Yes — resolvable npm environment |
| `npm run doctor` | Yes — plus Bun and an installed OMP host |
## Production loop
@@ -215,7 +211,7 @@ npm pack
The local test suite imports production code. The final host smoke test remains `omp plugin doctor` plus an interactive OMP session.
`npm run check`, `npm test`, and `npm run verify` require a complete `node_modules`; see [Verification status](#verification-status) for what currently passes and what is blocked.
`npm run check`, `npm test`, and `npm run verify` require a complete `node_modules`; see [Verification status](#verification-status) for the recorded gate evidence.
## Governing law