flowstate-connector-google-drive Package Skill

Package: @epicdm/flowstate-connector-google-drive Repository: epic-flowstate-community Path: packages/flowstate-connector-google-drive 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 Connector Google Drive Maintenance

Status: Active Purpose: Keep the Google Drive connector manifest, docs, tests, and plugin metadata aligned. Scope: packages/flowstate-connector-google-drive and connector-core references. Trigger: Manifest edits, plugin metadata edits, docs, tests, build target, Dojo rebuild, or plugin publish. Input: Proposed package change and verification context. Output: Verified connector package state.

Source Of Truth Order

1. connector.yaml
2. __tests__/connector.test.ts
3. flowstate.plugin.json
4. connector-core manifest tests that read this package directly
5. README
6. generated .flowstate/dojo

There is no packages/connector-core/manifests/google-drive.yaml bundled copy at review time.

Tests

Package tests validate:

• schema parse
• manifest version
• OAuth2 scopes
• pull-only direction
• delta request template
• documents-only target
• plugin JSON connector contribution

Run:

yarn workspace @epicdm/flowstate-connector-google-drive test --runInBand

Connector-core reference test:

yarn workspace @epicdm/connector-core test --runInBand src/manifest/__tests__/bundled-manifests.test.ts

CLI plugin build validates this package's plugin manifest and connector YAML:

flowstate plugin build

The OAuth install picker currently treats Cloud OAuth proxy as unavailable, so v1 install workflows use BYO Google OAuth credentials.

Build And Publish

build is intentionally no-op:

connector plugins have no build step - connector.yaml is the source of truth

Plugin publish:

yarn workspace @epicdm/flowstate-connector-google-drive publish:plugin

Drift Checks

Verification

yarn workspace @epicdm/flowstate-connector-google-drive build
yarn nx build @epicdm/flowstate-connector-google-drive

Created: 2026-06-29

Package Skill Inventory

@epicdm/flowstate-connector-google-drive Skill Inventory

Composition Guidance

Use this package as a manifest-only connector:

• Setup/auth: flowstate-connector-google-drive-manifest
• Endpoint sync behavior: flowstate-connector-google-drive-sync
• Document fields: flowstate-connector-google-drive-mapping
• Verification/publishing: flowstate-connector-google-drive-maintenance

Do not split skills by every YAML field. The useful learning shape is operator setup, sync behavior, mapping, and maintenance.

Review Gate

@epicdm/flowstate-connector-google-drive Skill Review

Review Summary

Created package-local operating skills for the Google Drive connector under packages/flowstate-connector-google-drive/.flowstate/skills.

The skillset is manifest-oriented because this package has no TypeScript source exports. It teaches OAuth setup, list-files cursor/delta sync behavior, metadata-only document mapping, and maintenance.

Evidence Reviewed

• package.json
• README.md
• connector.yaml
• flowstate.plugin.json
• __tests__/connector.test.ts
• .flowstate/feature-matrix/inventory.md
• .flowstate/dojo/agent-skillset.md
• packages/connector-core/src/manifest/__tests__/bundled-manifests.test.ts
• packages/connector-core/src/manifest/schema.ts
• packages/flowstate-cli/src/templates/compose/services.ts
• packages/flowstate-cli/src/cli-commands/plugin/build.ts
• packages/flowstate-cli/src/cli-commands/plugin/oauth-picker.ts

Known Drift Preserved

• No JS/TS public exports exist.
• V1 manifest syncs metadata only, not file content.
• Plugin JSON says "metadata + readonly content", which is ahead of manifest reality.
• README mentions webhook delta cursor and 6-hour poll; manifest only declares list-files with cursor pagination and modifiedTime delta predicate.
• No connector-core bundled google-drive.yaml exists at review time; connector-core tests read this package directly.
• Generated Dojo material is generic and not publish-ready.
• CLI plugin build validates contributed connector YAML; OAuth install currently relies on BYO credentials because the cloud proxy is unavailable.
• Generated Dojo publisher identifiers drift between generated files.

Verification Status

Completed after authoring:

• ASCII scan: passed.
• Frontmatter scan: passed.
• yarn workspace @epicdm/flowstate-connector-google-drive test --runInBand: passed, 1 suite and 7 tests.
• yarn workspace @epicdm/flowstate-connector-google-drive build: passed; printed no-build message by design.
• yarn nx build @epicdm/flowstate-connector-google-drive: passed with cached dependency outputs and connector no-build target; Nx Cloud setup notice reported.

Dojo publication remains deferred until local skills pass verification and review.

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/flowstate-connector-google-drive/package.json. Do not treat generated feature lists as lessons; use workflow evidence from CODE-REVIEW.md, SKILL-INVENTORY.md, and REVIEW.md.