@opentiny/tiny-robot-cli 0.5.2-alpha.15 → 0.5.2-alpha.16

package/README.md

@@ -13,11 +13,12 @@ npx @opentiny/tiny-robot-cli add chat --yes
 ## Options
 
 - `-t, --template <name>`: template name; `basic` generates the Chat Basic project
+- `--runtime-version <version>`: override the TinyRobot runtime version for local CLI development or diagnosis
 - `-h, --help`: show help
 
 `create` is an overall project scaffold. The `basic` template is aligned with `packages/chat-basic` and is copied into a new project.
 
-`add chat` is a local feature injection for an existing Vue project. It creates the isolated `src/tiny-robot-chat/` feature from `packages/cli/templates/chat`, adds the runtime dependencies (including `@vueuse/core`), and imports the feature CSS. It does not modify the host project's Vite configuration. Existing files with different contents are reported as conflicts and are never silently overwritten.
+`add chat` is a local feature injection for an existing Vue project. It creates the isolated `src/tiny-robot-chat/` feature from `packages/cli/templates/chat`, adds the runtime dependencies (including `@vueuse/core@13.9.0`), and imports feature-scoped CSS that does not reset the host document. It does not modify the host project's Vite configuration. Existing files with different contents are reported as conflicts and are never silently overwritten.
 
 By default, `add chat` mounts `TinyRobotChat` into a standard `src/App.vue` when a safe template and script setup block are available, so the generated project includes the floating AI trigger. Use `--no-mount` to keep `App.vue` unchanged and print the mount snippet. Use `--dry-run` to inspect the plan without changing files and `--yes` to skip prompts:
 
@@ -35,6 +36,16 @@ The feature adds or preserves these dependencies. Compatible versions are kept,
 - `@opentiny/tiny-robot-svgs`
 - `@vueuse/core`
 
+Both `create` and `add chat` derive TinyRobot runtime dependency versions from the CLI package version. Prerelease CLI versions use the same exact runtime version, while stable CLI versions use a caret range:
+
+```text
+CLI 0.5.2-alpha.15 -> runtime 0.5.2-alpha.15
+CLI 0.5.2-beta.3   -> runtime 0.5.2-beta.3
+CLI 0.5.3          -> runtime ^0.5.3
+```
+
+An existing dependency range is preserved when it accepts the target runtime version; for example, `^0.5.1` is kept for a stable `0.5.3` target. Use `--runtime-version` only when testing an unpublished CLI checkout or diagnosing version resolution. The override follows the same prerelease-exact and stable-caret rules.
+
 Copy the generated `.env.example` to `.env.local`, then configure the provider API URL and API key before starting the project. `add chat` does not create or modify `.env`.
 
 The Model Context MCP example uses `/modelcontextprotocol-mcp`. Add this proxy manually to the existing `vite.config.*` file under `server.proxy`, then restart Vite:

package/bin/commands/add.js

@@ -6,6 +6,7 @@ import path from 'node:path'
 import process from 'node:process'
 import semver from 'semver'
 
+import { createRuntimeDependencies, resolveRuntimeVersion } from '../runtime-version.js'
 import {
   findProjectRoot,
   findSubPackageRoot,
@@ -19,15 +20,7 @@ import {
   mergeEnvContent,
 } from '../utils.js'
 
-const TARGET_VERSION = '0.5.2-alpha.15'
 const CHAT_ADD_FEATURE_DIR = 'src/tiny-robot-chat'
-const DEPENDENCIES = {
-  '@opentiny/tiny-robot': TARGET_VERSION,
-  '@opentiny/tiny-robot-chat': TARGET_VERSION,
-  '@opentiny/tiny-robot-kit': TARGET_VERSION,
-  '@opentiny/tiny-robot-svgs': TARGET_VERSION,
-  '@vueuse/core': '13.1.0',
-}
 const PACKAGE_STYLE_IMPORTS = [
   "import '@opentiny/tiny-robot/dist/style.css'",
   "import '@opentiny/tiny-robot-chat/dist/style.css'",
@@ -189,7 +182,11 @@ function insertDependencyOrdered(dependencies, name, version) {
   return next
 }
 
-function ensureDependency(pkg, name, targetVersion) {
+function ensureDependency(pkg, name, targetSpecifier) {
+  const targetMinimum = semver.minVersion(targetSpecifier)
+  invariant(targetMinimum, `${name} has an invalid target version specifier (${targetSpecifier})`)
+  const targetVersion = targetMinimum.version
+
   for (const section of ['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies']) {
     const value = pkg[section]
     if (value !== undefined && (value === null || typeof value !== 'object' || Array.isArray(value))) {
@@ -210,8 +207,8 @@ function ensureDependency(pkg, name, targetVersion) {
       return { type: 'conflict', reason: 'dependencies must be a JSON object' }
     }
     pkg.dependencies ??= {}
-    pkg.dependencies = insertDependencyOrdered(pkg.dependencies, name, targetVersion)
-    return { type: 'added', to: targetVersion, section: 'dependencies' }
+    pkg.dependencies = insertDependencyOrdered(pkg.dependencies, name, targetSpecifier)
+    return { type: 'added', to: targetSpecifier, section: 'dependencies' }
   }
 
   const dependency = existing[0]
@@ -226,12 +223,13 @@ function ensureDependency(pkg, name, targetVersion) {
     }
   }
 
-  const satisfies = semver.satisfies(targetVersion, dependency.version, { includePrerelease: true })
+  const satisfies = semver.satisfies(targetVersion, dependency.version)
 
   if (satisfies) return { type: 'skipped', section: dependency.section, version: dependency.version }
 
   const minimum = typeof dependency.version === 'string' ? semver.minVersion(dependency.version) : null
   if (
+    semver.prerelease(targetVersion) === null &&
     typeof dependency.version === 'string' &&
     ((semver.valid(dependency.version) && semver.gte(dependency.version, targetVersion)) ||
       (minimum && semver.gte(minimum, targetVersion)))
@@ -242,16 +240,16 @@ function ensureDependency(pkg, name, targetVersion) {
   if (dependency.section !== 'dependencies') {
     return {
       type: 'conflict',
-      reason: `${name}@${dependency.version} in ${dependency.section} does not satisfy ${targetVersion}`,
+      reason: `${name}@${dependency.version} in ${dependency.section} does not satisfy ${targetSpecifier}`,
     }
   }
 
-  pkg.dependencies[name] = targetVersion
+  pkg.dependencies[name] = targetSpecifier
   return {
     type: 'updated',
     section: dependency.section,
     from: dependency.version,
-    to: targetVersion,
+    to: targetSpecifier,
   }
 }
 
@@ -412,10 +410,10 @@ function isSelected(selectedFiles, label) {
   return selectedFiles.includes(label)
 }
 
-function getDependencyPlan(pkg) {
+function getDependencyPlan(pkg, dependencies) {
   const preview = JSON.parse(JSON.stringify(pkg))
 
-  return Object.entries(DEPENDENCIES).map(([name, version]) => ({
+  return Object.entries(dependencies).map(([name, version]) => ({
     name,
     result: ensureDependency(preview, name, version),
   }))
@@ -493,7 +491,7 @@ function applyChanges(changes) {
   }
 }
 
-function validateSelection(selectedFiles, pkg, featureInspection, mountPlan, allowManualMount) {
+function validateSelection(selectedFiles, pkg, featureInspection, mountPlan, allowManualMount, dependencies) {
   const featureFilesSelected = isSelected(selectedFiles, 'Chat feature files')
   const featureFilesMissing = featureInspection.some((file) => file.type === 'create')
 
@@ -511,7 +509,7 @@ function validateSelection(selectedFiles, pkg, featureInspection, mountPlan, all
 
   if (isSelected(selectedFiles, 'package.json')) return
 
-  const dependencyChanges = getDependencyPlan(pkg).filter(({ result }) => result.type !== 'skipped')
+  const dependencyChanges = getDependencyPlan(pkg, dependencies).filter(({ result }) => result.type !== 'skipped')
   if (dependencyChanges.length > 0 && (featureFilesSelected || isSelected(selectedFiles, 'main entry style imports'))) {
     throw new Error(
       'Select package.json when adding the chat feature or its style imports so required dependencies can be checked.',
@@ -520,7 +518,7 @@ function validateSelection(selectedFiles, pkg, featureInspection, mountPlan, all
 }
 
 function prepareChanges(targetDir, selectedFiles, context) {
-  const { featureInspection, mainFile, mountPlan, pkgPath, pkg, allowConflicts } = context
+  const { featureInspection, mainFile, mountPlan, pkgPath, pkg, allowConflicts, dependencies } = context
   const changes = []
   const results = { featureInspection, style: null, env: null, dependencies: [], mount: null, dependencyChanged: false }
 
@@ -564,7 +562,7 @@ function prepareChanges(targetDir, selectedFiles, context) {
   }
 
   if (isSelected(selectedFiles, 'package.json')) {
-    for (const [name, version] of Object.entries(DEPENDENCIES)) {
+    for (const [name, version] of Object.entries(dependencies)) {
       const result = ensureDependency(pkg, name, version)
       if (result.type === 'conflict' && !allowConflicts) throw new Error(`${name}: ${result.reason}`)
       results.dependencies.push({ name, result })
@@ -637,7 +635,7 @@ async function addFeature(targetDir, type, options) {
     nonInteractive: options.nonInteractive,
   })
 
-  validateSelection(selectedFiles, pkg, featureInspection, mountPlan, options.dryRun)
+  validateSelection(selectedFiles, pkg, featureInspection, mountPlan, options.dryRun, options.dependencies)
   const prepared = prepareChanges(targetDir, selectedFiles, {
     featureInspection,
     mainFile,
@@ -645,6 +643,7 @@ async function addFeature(targetDir, type, options) {
     pkgPath,
     pkg,
     allowConflicts: options.dryRun,
+    dependencies: options.dependencies,
   })
 
   if (options.dryRun) {
@@ -660,7 +659,9 @@ async function addFeature(targetDir, type, options) {
       `  ${formatPlanStatus(prepared.results.env?.type ?? 'unavailable')} .env.example (${prepared.results.env?.type ?? 'not selected'})`,
     )
     const dependencyPlan =
-      prepared.results.dependencies.length > 0 ? prepared.results.dependencies : getDependencyPlan(pkg)
+      prepared.results.dependencies.length > 0
+        ? prepared.results.dependencies
+        : getDependencyPlan(pkg, options.dependencies)
     for (const { name, result } of dependencyPlan) {
       const status = result.type === 'added' || result.type === 'updated' ? '~' : result.type === 'conflict' ? '!' : '○'
       console.log(`  ${status} package.json (${result.type}: ${name})`)
@@ -733,11 +734,17 @@ export function registerAddCommand(program) {
     .option('--dry-run', 'print the change plan without modifying files')
     .option('--mount', 'safely mount TinyRobotChat in src/App.vue (default)')
     .option('--no-mount', 'keep App.vue unchanged and print the mount snippet')
+    .option('--runtime-version <version>', 'override the TinyRobot runtime version')
     .action(async (type, options) => {
       try {
+        const runtime = resolveRuntimeVersion(options.runtimeVersion)
         const nonInteractive = Boolean(options.yes || options.dryRun || !process.stdout.isTTY)
         const targetDir = await resolveTargetPackage(process.cwd(), nonInteractive)
-        await addFeature(targetDir, type, { ...options, nonInteractive })
+        await addFeature(targetDir, type, {
+          ...options,
+          dependencies: createRuntimeDependencies(runtime.specifier),
+          nonInteractive,
+        })
       } catch (error) {
         if (error instanceof Error && error.name === 'ExitPromptError') {
           console.error('\nOperation cancelled.')
@@ -749,4 +756,4 @@ export function registerAddCommand(program) {
     })
 }
 
-export { DEPENDENCIES, ensureDependency, ensureStyleImports, getChatFeatureFiles, planMount, resolveTargetPackage }
+export { ensureDependency, ensureStyleImports, getChatFeatureFiles, planMount, resolveTargetPackage }

package/bin/commands/create.js

@@ -2,6 +2,7 @@ import { input, select } from '@inquirer/prompts'
 import path from 'node:path'
 import process from 'node:process'
 
+import { resolveRuntimeVersion } from '../runtime-version.js'
 import {
   DEFAULT_PROJECT_NAME,
   DEFAULT_TEMPLATE,
@@ -119,12 +120,13 @@ function printCreateSuccess(projectName) {
   console.log()
 }
 
-async function createProject(initialProjectName, initialTemplateName, skipPrompt) {
+async function createProject(initialProjectName, initialTemplateName, runtimeVersion, skipPrompt) {
+  const runtime = resolveRuntimeVersion(runtimeVersion)
   const options = await resolveCreateOptions(initialProjectName, initialTemplateName, skipPrompt)
 
   const { templateDir, targetDir } = validateCreateOptions(options)
 
-  scaffoldProject(templateDir, targetDir, options.projectName)
+  scaffoldProject(templateDir, targetDir, options.projectName, runtime.specifier)
 
   printCreateSuccess(options.projectName)
 }
@@ -134,10 +136,11 @@ export function registerCreateCommand(program) {
     .command('create [project-name]')
     .description('Create a TinyRobot project from template')
     .option('-t, --template <name>', 'template name')
+    .option('--runtime-version <version>', 'override the TinyRobot runtime version')
     .action((projectName, options) => {
       const skipPrompt = !process.stdout.isTTY
 
-      createProject(projectName ?? '', options.template ?? '', skipPrompt).catch((error) => {
+      createProject(projectName ?? '', options.template ?? '', options.runtimeVersion, skipPrompt).catch((error) => {
         if (error instanceof Error && error.name === 'ExitPromptError') {
           console.error('\nOperation cancelled.')
           process.exit(1)

package/bin/runtime-version.js

@@ -0,0 +1,37 @@
+import fs from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import semver from 'semver'
+
+const CLI_PACKAGE_FILE = fileURLToPath(new URL('../package.json', import.meta.url))
+
+export function readCliVersion() {
+  const packageJson = JSON.parse(fs.readFileSync(CLI_PACKAGE_FILE, 'utf8'))
+  return packageJson.version
+}
+
+export function formatRuntimeSpecifier(version) {
+  const parsedVersion = typeof version === 'string' ? semver.parse(version) : null
+  const canonicalVersion = parsedVersion
+    ? `${parsedVersion.version}${parsedVersion.build.length > 0 ? `+${parsedVersion.build.join('.')}` : ''}`
+    : null
+  if (!parsedVersion || canonicalVersion !== version) {
+    throw new Error(`Runtime version must be a valid semantic version: ${String(version)}`)
+  }
+
+  return parsedVersion.prerelease.length > 0 ? version : `^${version}`
+}
+
+export function resolveRuntimeVersion(override) {
+  const version = override ?? readCliVersion()
+  return { version, specifier: formatRuntimeSpecifier(version) }
+}
+
+export function createRuntimeDependencies(specifier) {
+  return {
+    '@opentiny/tiny-robot': specifier,
+    '@opentiny/tiny-robot-chat': specifier,
+    '@opentiny/tiny-robot-kit': specifier,
+    '@opentiny/tiny-robot-svgs': specifier,
+    '@vueuse/core': '13.9.0',
+  }
+}

package/bin/utils.js

@@ -5,6 +5,7 @@ import pc from 'picocolors'
 import yaml from 'yaml'
 
 const TEMPLATE_PLACEHOLDER = '__PROJECT_NAME__'
+const RUNTIME_VERSION_PLACEHOLDER = '__TINY_ROBOT_VERSION__'
 
 export const BUILTIN_TEMPLATES = ['basic']
 export const DEFAULT_TEMPLATE = 'basic'
@@ -130,13 +131,14 @@ function replaceTemplateVariables(targetDir, variables) {
   }
 }
 
-export function scaffoldProject(templateDir, targetDir, projectName) {
+export function scaffoldProject(templateDir, targetDir, projectName, runtimeVersion) {
   copyTemplate(templateDir, targetDir)
 
   renameSpecialFiles(targetDir)
 
   replaceTemplateVariables(targetDir, {
     [TEMPLATE_PLACEHOLDER]: projectName,
+    [RUNTIME_VERSION_PLACEHOLDER]: runtimeVersion,
   })
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentiny/tiny-robot-cli",
-  "version": "0.5.2-alpha.15",
+  "version": "0.5.2-alpha.16",
   "description": "CLI to scaffold TinyRobot product projects",
   "repository": {
     "type": "git",
@@ -34,5 +34,5 @@
     "semver": "^7.8.1",
     "yaml": "^2.9.0"
   },
-  "gitHead": "e6908488f65b8615cb9f40eacc8e216405a66d2c"
+  "gitHead": "1bad8116c3bf83194a44bcde3dbd970cb8aacdd2"
 }

package/templates/basic/package.json

@@ -9,9 +9,9 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@opentiny/tiny-robot-chat": "0.5.2-alpha.15",
-    "@opentiny/tiny-robot": "0.5.2-alpha.15",
-    "@opentiny/tiny-robot-svgs": "0.5.2-alpha.15",
+    "@opentiny/tiny-robot-chat": "__TINY_ROBOT_VERSION__",
+    "@opentiny/tiny-robot": "__TINY_ROBOT_VERSION__",
+    "@opentiny/tiny-robot-svgs": "__TINY_ROBOT_VERSION__",
     "vue": "^3.5.40"
   },
   "devDependencies": {

package/templates/chat/README.md

@@ -35,7 +35,7 @@ DeepSeek 模型默认继承 `low`、`high`、`max` 三档思考强度，默认
 - `src/config/chat-runtime.ts`: MCP 示例和模型配置。
 - `src/components`: 窗口头部和输入区工具。
 - `src/composables/useWindow.ts`: floating、fullscreen 窗口状态。
-- `src/index.css`: 模板公共样式和 Surface 样式变量。
+- `src/index.css`: 仅作用于 Chat 容器的组件样式和 Surface 样式变量，不重置宿主页面的全局样式。
 
 ## 替换数据
 

package/templates/chat/package.json

@@ -10,11 +10,11 @@
     "type-check": "vue-tsc -b"
   },
   "dependencies": {
-    "@opentiny/tiny-robot": "0.5.2-alpha.15",
-    "@opentiny/tiny-robot-chat": "0.5.2-alpha.15",
-    "@opentiny/tiny-robot-kit": "0.5.2-alpha.15",
-    "@opentiny/tiny-robot-svgs": "0.5.2-alpha.15",
-    "@vueuse/core": "13.1.0",
+    "@opentiny/tiny-robot": "__TINY_ROBOT_VERSION__",
+    "@opentiny/tiny-robot-chat": "__TINY_ROBOT_VERSION__",
+    "@opentiny/tiny-robot-kit": "__TINY_ROBOT_VERSION__",
+    "@opentiny/tiny-robot-svgs": "__TINY_ROBOT_VERSION__",
+    "@vueuse/core": "13.9.0",
     "vue": "^3.5.40"
   },
   "devDependencies": {

package/templates/chat/src/index.css

@@ -1,4 +1,5 @@
-:root {
+.chat-add-app,
+.chat-add-window {
   font-family:
     Inter,
     -apple-system,
@@ -7,20 +8,12 @@
     sans-serif;
   color: #1f2329;
 }
-* {
+.chat-add-app,
+.chat-add-app *,
+.chat-add-window,
+.chat-add-window * {
   box-sizing: border-box;
 }
-html,
-body,
-#app {
-  width: 100%;
-  height: 100%;
-  min-height: 0;
-  margin: 0;
-}
-body {
-  overflow: hidden;
-}
 .chat-add-app {
   position: relative;
   container-type: inline-size;