Files
pipdock/ui/src/ipc/index.ts
T
poli0981andClaude Opus 5 8f6b7ed24b feat: scaffold the Tauri shell, React UI and CI
Completes the Phase 0 scaffold. The app builds, links and renders; no
screens yet.

Frontend (ARCHITECTURE section 9, UI-SPEC section 2):
- React 19 + Vite 8 + Tailwind 4 with the UI-SPEC dark terminal-tech
  tokens, plus a contrast test asserting WCAG AA over every
  text/surface pair, which UI-SPEC section 8 requires be verified.
- EN and VI catalogs with a test that vi has every en key and no
  orphans, standing in for the CI parity script I18N section 1 asks for.
- A local eslint rule enforcing the no-hardcoded-JSX-strings policy.
  eslint-plugin-react was the obvious choice but caps at ESLint 9, which
  drags in six high-severity advisories that would fail npm audit in CI;
  a local rule also implements the documented allowlist (product name,
  package names, versions, catalog codes, glyphs) precisely, which
  react/jsx-no-literals cannot express. Verified it fires on real copy
  and stays quiet on all five allowed shapes.
- no-restricted-imports keeps invoke() out of components, so the
  "no component calls invoke directly" rule is enforced, not just stated.

Tauri (ARCHITECTURE section 7): commands and events only, identifier
com.skullmute.pipdock, NSIS and MSI targets, minimal capability set,
placeholder icon pending the Phase 3 branding pass.

CI (docs/RELEASE-CI.md section 1 as corrected):
- ci-rust.yml and release.yml are project-local, on Windows runners,
  because no reusable Rust or Tauri workflow exists in the ops repo.
  Windows matters here: env discovery reads the PEP 514 registry and the
  py launcher, so a Linux run would skip the code most likely to break.
- ci-node.yml calls the ops web-react reusable and adds the npm audit
  job that reusable lacks.
- codeql.yml is JS/TS only; CodeQL has no Rust analyzer.
- Discord notifiers replace the six-platform notify.yml that never
  existed. Every caller carries an explicit permissions block.
- Action versions checked against the registry rather than assumed:
  checkout v7, cache v6, gh-release v3, setup-node v6.

Two toolchain holds, both forced and both recorded:
- TypeScript 6.0.3, not 7: typescript-eslint peers on <6.1.0.
- ESLint 10 with eslint-plugin-react dropped, as above.

Verified: cargo fmt/clippy -D warnings/28 tests green, tsc clean,
18 vitest tests green, eslint clean, npm audit reports 0
vulnerabilities, vite build and both binaries link.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 17:44:39 +07:00

60 lines
1.9 KiB
TypeScript

/**
* The typed IPC boundary — ARCHITECTURE §9.
*
* **No component calls `invoke` directly.** Everything crosses through this module, which is the
* one place `@tauri-apps/api/core` may be imported (enforced by `no-restricted-imports` in
* `eslint.config.js`).
*
* In M2 the request/response types here are generated by `specta`/`tauri-specta` from the Rust
* definitions so drift between core and UI becomes a compile error rather than a runtime surprise.
* Until that generation is wired up, this module only declares the command names — which are
* already fixed by ARCHITECTURE §7 — so the surface is reviewable now.
*/
/** Every Tauri command, per ARCHITECTURE §7. All are async and all return `Result<T, PdError>`. */
export const COMMANDS = [
'env_scan',
'env_add_manual',
'env_probe',
'pkg_list',
'pkg_outdated',
'index_search',
'pkg_metadata',
'plan_resolve',
'plan_execute',
'plan_cancel',
'uninstall_guard',
'uninstall_execute',
'pin_list',
'pin_add',
'pin_remove',
'snapshot_list',
'snapshot_diff',
'snapshot_rollback',
'health_run',
'health_fix',
'settings_get',
'settings_set',
'logs_tail',
'pip_upgrade',
'legal_consent_get',
'legal_consent_set',
] as const
export type Command = (typeof COMMANDS)[number]
/** Tauri event channels, per ARCHITECTURE §7. */
export const EVENTS = ['plan-progress', 'scan-progress', 'health-progress'] as const
export type EventName = (typeof EVENTS)[number]
/** The error shape every command rejects with; mirrors `pipdock_core::errors::PdError`. */
export interface PdError {
/** Catalog code, e.g. `PD-BLD-002`. Never localized (docs/I18N.md §1). */
code: string
/** Developer-facing detail. The user-facing one-liner is looked up from `code`. */
message: string
/** Engine stderr tail, at most 40 lines (docs/ERROR-CATALOG.md §3). */
stderrTail?: string
}