[v6][audit] gql + graphql plugins exist in source but are NOT exposed in the zfa CLI / manifest — verified 2026-08-05

[arrrrny]

Expected

Every generator plugin under lib/src/plugins/ is invocable (via zfa <plugin>) or at least listed in zfa manifest.

Actual

• zfa --help (34 commands) has no gql or graphql command.
• zfa manifest capabilities omit both plugins.
• lib/src/plugins/graphql/graphql_plugin.dart docstring: "This is currently a placeholder for the schema-to-dart feature." (introspection service exists in lib/src/graphql/: graphql_introspection_service.dart, schema_parser.dart, schema_cache.dart — but the plugin is not wired into the CLI).

Cross-check: lib/src/plugins/ (24 dirs) vs CLI/manifest (verified live)

Plugin dir	zfa command	manifest
api, cache, controller, datasource, di, feature, mock, module, observer, presenter, provider, repository, route, service, shadcn, state, strategy	yes	yes (most)
usecase, view, test, sync	via make	yes
method_append	via make	yes
gql	no	no
graphql	no (placeholder)	no

Consumer impact

First real-world consumer hit this: the vendure-flutter-sdk rewrite (arrrrny/vendure-flutter-sdk issue #6) requires schema-driven generation (zfa graphql introspect against a live Vendure shop-api). The command does not exist — the rewrite is forced to hand-write entities (fallback), and this is the graphql plugin's first real-world test that never happened.

Request

• Complete the graphql/gql plugin tracks and register/expose them in the CLI + manifest.
• Until then, remove the placeholder state or fail with a clear 'not implemented' error instead of a silent missing command.

Related

Epic #164 · Tracks #174 #175 #178 · Bug #231 (missing naming_utils.dart)

[coderabbitai]

🔗 Related PRs

#148 - feat: VM Service API Plugin — Auto-Generated Runtime RPC Bridge (v5.4.0) [merged]
#197 - feat(graphql): Track 3.1 — graphql_core foundation package [merged]
#198 - feat(graphql): Track 3.2 — Schema-to-Full-Stack Generation [merged]
#206 - feat(graphql): Track 3.5 — gql Plugin: Real .graphql File Generation & Datasource Integration [merged]
#241 - feat(v6): micro-frontend baseline — ZuraffaPlugin/ZuraffaEngine + zfa module [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!