@hydranium/cli 1.0.0-next.42 → 1.0.0-next.421

package/lib/commands/init-skills.js

@@ -0,0 +1,110 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { spawnSync } from 'node:child_process';
+import * as path from 'node:path';
+import { InitWizardCancelled } from './init-prompt.js';
+import { checkSkills } from './skills.js';
+export const SKILLS_INSTALLER = 'skills@1.7.6';
+export const ADOPTER_SKILLS = {
+    'hydranium-profiling': { source: 'eclipse-emfcloud/hydranium', label: 'Hydranium profiling' },
+    langium: { source: 'eclipse-langium/langium-ai', label: 'Langium grammar and runtime' }
+};
+export const SKILL_AGENTS = {
+    codex: 'Codex',
+    'claude-code': 'Claude Code',
+    cursor: 'Cursor',
+    'github-copilot': 'GitHub Copilot',
+    opencode: 'OpenCode'
+};
+/** Validate before scaffolding so a misspelling cannot leave a half-completed command. */
+export function parseSkillInstallation(skills, agents) {
+    if (skills === undefined && agents === undefined) {
+        return undefined;
+    }
+    if (!skills || !agents) {
+        throw new Error('--skills and --agents must be supplied together.');
+    }
+    const selectedSkills = skills.split(',');
+    const selectedAgents = agents.split(',');
+    for (const name of selectedSkills) {
+        if (!Object.hasOwn(ADOPTER_SKILLS, name)) {
+            throw new Error(`Unknown skill '${name}'. Choose ${Object.keys(ADOPTER_SKILLS).join(', ')}.`);
+        }
+    }
+    for (const name of selectedAgents) {
+        if (!Object.hasOwn(SKILL_AGENTS, name)) {
+            throw new Error(`Unknown agent '${name}'. Choose ${Object.keys(SKILL_AGENTS).join(', ')}.`);
+        }
+    }
+    return { skills: [...new Set(selectedSkills)], agents: [...new Set(selectedAgents)] };
+}
+export function skillInstallArgs(skill, agents) {
+    return ['--yes', SKILLS_INSTALLER, 'add', ADOPTER_SKILLS[skill].source, '--skill', skill, '--agent', ...agents, '--copy', '--yes'];
+}
+/** A failed optional download leaves the scaffold usable and gives an independently runnable retry. */
+export function installSkills(project, from, selection, write = message => process.stdout.write(message)) {
+    for (const skill of selection.skills) {
+        const args = skillInstallArgs(skill, selection.agents);
+        write(`\nIn ${project}: npx ${args.join(' ')}\n`);
+        try {
+            // Only catalogued names reach the Windows shim's shell; paths travel as cwd, never shell text.
+            const result = spawnSync(process.platform === 'win32' ? 'npx.cmd' : 'npx', args, {
+                cwd: project,
+                stdio: 'inherit',
+                shell: process.platform === 'win32'
+            });
+            if (result.signal === 'SIGINT' || result.status === 130) {
+                write('Skill installation cancelled. Scaffold kept.\n');
+                return;
+            }
+            if (result.error || result.signal || result.status !== 0) {
+                throw result.error ?? new Error(result.signal ?? `exit code ${result.status}`);
+            }
+            for (const result of checkSkills(project, from, [skill])) {
+                write(`${result.status}: ${result.file}: ${result.detail}\n`);
+            }
+        }
+        catch (error) {
+            write(`Skill installation failed (${error instanceof Error ? error.message : String(error)}). Scaffold kept.\n`);
+            write(`Retry in ${project}: npx ${args.join(' ')}\n`);
+        }
+    }
+    const relative = path.relative(project, from) || '.';
+    const quoted = `'${relative.replace(/'/g, "'\\''")}'`;
+    write(`Check again after installing or updating dependencies: npx hydranium-cli check-skills --from ${quoted}\n`);
+}
+/** This prompt runs only after the scaffold succeeds; cancelling it cannot undo the scaffold. */
+export async function offerSkills(prompt, project) {
+    try {
+        prompt.intro('Optional coding-agent skills');
+        if (!(await prompt.confirm({ message: `Install coding-agent skills in ${project}?`, initialValue: false }))) {
+            prompt.outro('Skills skipped.');
+            return undefined;
+        }
+        const skills = await prompt.multiselect({
+            message: 'Skills to install',
+            choices: Object.entries(ADOPTER_SKILLS).map(([value, skill]) => ({ value: value, label: skill.label })),
+            initialValues: ['hydranium-profiling', 'langium']
+        });
+        const agents = await prompt.multiselect({
+            message: 'Coding agents',
+            choices: Object.entries(SKILL_AGENTS).map(([value, label]) => ({ value: value, label }))
+        });
+        prompt.outro('Installing selected skills as project files. Commit the files and skills-lock.json.');
+        return { skills, agents };
+    }
+    catch (error) {
+        if (error instanceof InitWizardCancelled) {
+            prompt.outro('Skills skipped. Scaffold kept.');
+            return undefined;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=init-skills.js.map

package/lib/commands/init-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-skills.js","sourceRoot":"","sources":["../../src/commands/init-skills.ts"],"names":[],"mappings":"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"}

package/lib/commands/init-templates.d.ts

@@ -6,21 +6,12 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
-import type { InitComposition, InitFile } from './init.js';
+import { type InitComposition, type InitFile, type InitMember } from './init.js';
 /** One template file: its path (tokens allowed) and its content (tokens allowed). */
 export interface InitTemplate {
     path: string;
     content: string;
 }
-/**
- * The version every framework package carries before the first release.
- *
- * A scaffold made by a CLI still at this version pins a range the registry
- * cannot serve, so the emitted README keeps its yalc note and `init` keeps its
- * install warning while — and only while — it holds: from a published CLI the
- * derived pins resolve and either note would be false as printed.
- */
-export declare const UNPUBLISHED_FRAMEWORK_VERSION = "0.0.0";
 /**
  * The version `init` pins every `@hydranium/*` dependency at: the scaffolding
  * CLI's own.
@@ -32,11 +23,26 @@ export declare const UNPUBLISHED_FRAMEWORK_VERSION = "0.0.0";
  */
 export declare function readFrameworkVersion(): string;
 /**
- * Every file the scaffold emits, fully rendered.
+ * A member's package name: `<id>-<member>`, under the scope when there is one,
+ * except for the VS Code extensions, whose scoped name `vsce` refuses to
+ * package.
  *
- * Grammar-count-dependent emissions live here rather than in a template string:
- * one `.langium` file per grammar, and the shared `common.langium` fragment only
- * when there is more than one grammar to share it.
+ * Suffixed even for the server, because a project of several packages has no
+ * member entitled to the bare id, and a later client or host would otherwise
+ * read as a part of the server.
+ */
+export declare function memberPackageName(composition: InitComposition, member: InitMember): string;
+/**
+ * The exact pins of every member the composition emits, for a workspace root
+ * to declare too. npm installs a root's own dependencies at the top of the
+ * tree, so another member's version of one nests beneath that member instead of
+ * taking the place of the copy this package shares with the framework.
+ */
+export declare function workspaceRootPins(composition: InitComposition): ReadonlyArray<readonly [string, string]>;
+/**
+ * Every file the scaffold emits, fully rendered, at its path in the project
+ * directory. A workspace member's project gets no root of its own: it joins the
+ * surrounding workspace, whose manifest `init` prints the changes for.
  */
 export declare function buildInitTemplates(composition: InitComposition): InitFile[];
 //# sourceMappingURL=init-templates.d.ts.map

package/lib/commands/init-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/commands/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAoElF,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAA8B,MAAM,WAAW,CAAC;AAGvF,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,UAAU,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAi3DD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,eAAe,GAAG,QAAQ,EAAE,CAqD3E"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/commands/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AA2FlF,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,QAAQ,EAAwC,KAAK,UAAU,EAAe,MAAM,WAAW,CAAC;AAIpI,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAqBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAI1F;AAuRD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqBxG;AAqiID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,eAAe,GAAG,QAAQ,EAAE,CAc3E"}