Sign in
atomic

flowstate-flowstate-desktop-epicdm-flowstate-desktop-app

Package-local agent skill for @epicdm/flowstate-desktop-app.

Tags

flowstatepackageflowstate-desktop

Publisher

Versions

1 version published — latest: 1.0.0

  • 1.0.0
    publishedInvalid Date

Skill

flowstate-desktop-app Package Skill

Package: @epicdm/flowstate-desktop-app Repository: flowstate-desktop Path: packages/desktop Version: 1.0.0

Use this published Dojo skill as the package-level entrypoint. For detailed workflows, use the package-local skills listed below.

Primary Package Workflow

FlowState Desktop Drive Provider

Use this skill for FlowState Drive and native file-provider work.

Start Here

Read:

  • src/services/TauriDriveService.ts
  • src/components/TauriDrivePage.tsx
  • src-tauri/tauri.conf.json
  • src-tauri/prepare-drive-daemon-sidecar.sh
  • macos/Package.swift
  • macos/FlowStateDriveProvider/FlowStateDriveProvider.swift
  • macos/FlowStateDriveProvider/FlowStateIPCClient.swift
  • src/__tests__/macosPackaging.test.ts

Rules

  1. Keep main app and File Provider extension app group identifiers aligned.
  2. Keep keychain access groups aligned for Drive auth handoff.
  3. Preserve flowstate-drive-daemon sidecar packaging in Tauri config.
  4. Update packaging tests when entitlements, sidecar paths, or File Provider metadata change.
  5. Keep drive TypeScript request/response types aligned with Rust and Swift IPC contracts.
  6. Redact presigned URL secrets and signatures from diagnostics.

Verification

cd packages/desktop
npm test -- --runInBand src/__tests__/macosPackaging.test.ts
cd macos && swift test

Use Tauri build when sidecar or bundle config changes:

cd packages/desktop
npm run tauri:build

Package Skill Inventory

@epicdm/flowstate-desktop-app Skill Inventory

SkillPurpose
flowstate-desktop-tauri-shellWork with the Tauri React shell, framework container, providers, routes, and replication setup.
flowstate-desktop-plugin-marketplaceWork with desktop manifest loading, Module Federation plugin routes, marketplace install ledger, and dev manifests.
flowstate-desktop-native-bridgesWork with Tauri command bridges for auth, config, secrets, Docker, storage, and system resources.
flowstate-desktop-drive-providerWork with FlowState Drive, drive daemon packaging, macOS File Provider metadata, and drive service APIs.

Review Gate

@epicdm/flowstate-desktop-app Skill Review

Verdict

Pass with existing test drift.

Skills are source-backed and cover Tauri shell composition, plugin/marketplace loading, native bridges, and FlowState Drive packaging.

Verification

  • ASCII and skill frontmatter checks passed.
  • npm run typecheck passed from repo root.
  • npm run build passed in packages/desktop with large chunk warnings.
  • npm test failed existing TauriDrivePage.test.tsx assertions; 9 files and 79/87 tests passed. The failure path shows TypeError: service.cacheStatus is not a function, after which expected Drive page text is not rendered.

Run Tauri and Swift checks when native code changes:

cd packages/desktop
npm run tauri:build
cd macos && swift test

Follow-Ups

  • Reconcile TauriDrivePage tests/mocks with the current TauriDriveService API.
  • Rebuild generated Dojo content from reviewed package-local skills before publishing.

Usage

Start with this skill to understand the package purpose, then use the package-local focused skills for specific workflows. Keep this Dojo version aligned with packages/desktop/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.

Install

Run this in your project to install via CLI:

fscloud dojo skill install flowstate-flowstate-desktop-epicdm-flowstate-desktop-app --target <target> --out ./skills

Replace <target> with your agent target identifier. See the CLI docs for details.