fix(plugin): ask only for the plugin's identity when the languages are recorded

[MuHamza30]

The bug

plugin generate asked for the languages again on a project where sdk publish had already recorded them, and rewrote the languages block with whatever was picked. Reported in apimatic/apimatic-io#2258.

languages is the project's one list of SDK languages: sdk publish adds to it, and the portal and the plugin read it. plugin generate owns only the plugin block. So a project sdk publish has touched, with languages and no plugin block yet, should be asked for the plugin's name, id and version, and nothing else.

Cause

unattendedLanguages took the recorded languages only once the plugin block had a name and id:

export const unattendedLanguages = (state: PluginConfigState): readonly Language[] =>
  setUpConfig(state)?.recordedLanguages() ?? [];

Before a first plugin, that is always []. So the command showed the language picker, pre-ticked with the recorded languages, and recordLanguages(selection) wrote the picks back: new ones as {}, and an unpublished one the user unticked removed. The portal block and the rest of the file were kept; only languages was rewritten. Without a terminal, the same [] made it fail with "asks for its name and languages".

The change

Each question is asked only while its own answer is missing:

languages has a C#, TypeScript or Python entry	plugin has a name and id	Asks	Writes
yes	no (what sdk publish leaves)	the plugin's identity only (was: identity and languages)	plugin; languages untouched
no	yes	the languages only	the picks, as {}
no	no	both	both
yes	yes	nothing	nothing

• plugin-config-context.ts: recordedPluginLanguages replaces unattendedLanguages and reads the recorded languages whatever the plugin block holds. SetupQuestions names what a run has to ask.
• generate.ts: the two questions are decided once, up front. languages is written only when the user picked the languages, never from the file's own list. The publish-first confirm is skipped only when nothing is asked, so a user answering the identity questions still gets it, and a run that asks nothing still never blocks.
• prompts/plugin/generate.ts: without a terminal, the message names what would have been asked. For the languages, it also points at the file: add one to languages, for example "languages": { "typescript": {} }.
• Since the picker now only appears when no carryable language is recorded, it had nothing to pre-select or mark published. It starts with every language checked, and PluginConfig.initialLanguages goes (second commit).
• The command's help text and the README say when the languages are asked (third commit). The README paragraph is edited by hand, not regenerated.

Not changed: sdk publish, the portal (an empty languages still fails its build), and quickstart, whose adopt path rewrites languages, plugin and portal on an existing project. That is a separate issue.

Verifying it

On copies of a quickstart project (Petstore), one per case, run without a terminal against this branch's build (the check runs before any request):

Case	Before	After
languages: { csharp: {} }, no plugin	"asks for its name and languages"	"asks for its name"; file untouched
plugin, no languages	"asks for its name and languages"	"names no language the plugin can carry … Add one to its 'languages' block, for example …"; file untouched
neither	"asks for its name and languages"	same; file untouched

Tests

• generate.test.ts: the test that pinned the old behaviour ("asks for the languages of a project without a plugin block") is flipped. New tests cover identity-only with languages and portal left exactly as written, languages-only with and without a languages block, the two new no-terminal messages, the publish-first confirm when only the identity is asked, and escaping the identity prompt. Five tests whose case can no longer happen are removed: four cleared a recorded language in the picker, and one checked the config the picker was handed, which it no longer takes. Two move onto a config that still reaches the picker.
• plugin-config-context.test.ts: recordedPluginLanguages returns the recorded languages with or without a plugin block.
• 7 of the new and changed tests fail on dev and pass here.
• pnpm test: 1427 passing. pnpm build and ESLint clean.

🤖 Generated with Claude Code

[mrafnadeem-apimatic]

The behaviour is right: every row of the table traces through the code, and CI is green. The comments below are about simplicity and the conventions in .ai/instructions.md (readability, simple domain models, comments as a design smell).

[mrafnadeem-apimatic]

This comment describes the caller's condition and explains why the removed pre-selection is gone, which is narrating the change. Now that the method takes no config, the signature says the same thing. I'd drop it.

[mrafnadeem-apimatic]

check the comments

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[github-actions]

🎉 This PR is included in version 2.0.0-beta.1 🎉

The release is available on:

• npm package (@beta dist-tag)
• GitHub release

Your semantic-release bot 📦🚀