@telemetryos/cli 1.9.0 → 1.11.0

package/dist/types/api.d.ts

@@ -0,0 +1,44 @@
+export type ApplicationKind = 'git' | 'github' | 'uploaded' | null;
+export type Application = {
+    id: string;
+    title: string;
+    description: string;
+    kind: ApplicationKind;
+    baseImage: string;
+    buildWorkingPath?: string;
+    buildScript?: string;
+    buildOutputPath?: string;
+    buildEnvironmentVariables?: Record<string, string>;
+    versions?: ApplicationVersion[];
+    createdAt?: string;
+    updatedAt?: string;
+};
+export type ApplicationVersion = {
+    name?: string;
+    version?: string;
+    applicationId: string;
+    buildId: string;
+    applicationSpecifier: string;
+    publishedAt: string;
+};
+export type ApplicationBuild = {
+    id: string;
+    applicationId: string;
+    index: number;
+    state: 'pending' | 'building' | 'success' | 'failure' | 'failed' | 'cancelled';
+    logs: string[];
+    scheduledAt?: string;
+    startedAt?: string;
+    finishedAt?: string;
+};
+export type CreateApplicationRequest = {
+    kind: 'uploaded';
+    title: string;
+    description?: string;
+    baseImage: string;
+    baseImageRegistryAuth: string;
+    buildWorkingPath: string;
+    buildScript: string;
+    buildOutputPath: string;
+    buildEnvironmentVariables?: Record<string, string>;
+};

package/dist/types/api.js

@@ -0,0 +1 @@
+export {};

package/dist/types/applications.d.ts

@@ -0,0 +1,44 @@
+export type ApplicationKind = 'git' | 'github' | 'uploaded' | null;
+export type Application = {
+    id: string;
+    title: string;
+    description: string;
+    kind: ApplicationKind;
+    baseImage: string;
+    buildWorkingPath?: string;
+    buildScript?: string;
+    buildOutputPath?: string;
+    buildEnvironmentVariables?: Record<string, string>;
+    versions?: ApplicationVersion[];
+    createdAt?: string;
+    updatedAt?: string;
+};
+export type ApplicationVersion = {
+    name?: string;
+    version?: string;
+    applicationId: string;
+    buildId: string;
+    applicationSpecifier: string;
+    publishedAt: string;
+};
+export type ApplicationBuild = {
+    id: string;
+    applicationId: string;
+    index: number;
+    state: 'pending' | 'building' | 'success' | 'failure' | 'failed' | 'cancelled';
+    logs: string[];
+    scheduledAt?: string;
+    startedAt?: string;
+    finishedAt?: string;
+};
+export type CreateApplicationRequest = {
+    kind: 'uploaded';
+    title: string;
+    description?: string;
+    baseImage: string;
+    baseImageRegistryAuth: string;
+    buildWorkingPath: string;
+    buildScript: string;
+    buildOutputPath: string;
+    buildEnvironmentVariables?: Record<string, string>;
+};

package/dist/types/applications.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/ansi.d.ts

@@ -0,0 +1,10 @@
+export declare const ansi: {
+    readonly white: "\u001B[37m";
+    readonly yellow: "\u001B[33m";
+    readonly green: "\u001B[32m";
+    readonly cyan: "\u001B[36m";
+    readonly red: "\u001B[31m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly reset: "\u001B[0m";
+};

package/dist/utils/ansi.js

@@ -0,0 +1,10 @@
+export const ansi = {
+    white: '\u001b[37m',
+    yellow: '\u001b[33m',
+    green: '\u001b[32m',
+    cyan: '\u001b[36m',
+    red: '\u001b[31m',
+    bold: '\u001b[1m',
+    dim: '\u001b[2m',
+    reset: '\u001b[0m',
+};

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Converts a string to kebab-case
+ *
+ * @param str - The string to convert
+ * @returns The kebab-cased string
+ *
+ * @example
+ * toKebabCase('MyApp') // 'my-app'
+ * toKebabCase('my_app') // 'my-app'
+ * toKebabCase('My App!') // 'my-app'
+ * toKebabCase('my--app') // 'my-app'
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Derives a project name from a given path
+ *
+ * @param projectPath - The path to derive the name from
+ * @param currentWorkingDirectory - The current working directory (defaults to process.cwd())
+ * @returns The derived project name in kebab-case
+ *
+ * @example
+ * deriveProjectName('my-project') // 'my-project'
+ * deriveProjectName('apps/MyApp') // 'my-app'
+ * deriveProjectName('./', '/Users/test/MyProject') // 'my-project'
+ * deriveProjectName('../parent') // 'parent'
+ * deriveProjectName('/absolute/path/to/app') // 'app'
+ */
+export declare function deriveProjectName(projectPath: string, currentWorkingDirectory?: string): string;
+/**
+ * Resolves a project path and derives the name
+ *
+ * @param projectPath - The path to resolve
+ * @param currentWorkingDirectory - The current working directory (defaults to process.cwd())
+ * @returns An object containing the resolved path and derived name
+ *
+ * @example
+ * resolveProjectPathAndName('apps/MyApp')
+ * // { resolvedPath: '/Users/user/cwd/apps/MyApp', derivedName: 'my-app' }
+ */
+export declare function resolveProjectPathAndName(projectPath: string, currentWorkingDirectory?: string): {
+    resolvedPath: string;
+    derivedName: string;
+};
+/**
+ * Validates a project name according to npm package name requirements
+ *
+ * @param name - The project name to validate
+ * @returns true if valid, or an error message string if invalid
+ *
+ * @example
+ * validateProjectName('my-app') // true
+ * validateProjectName('') // 'Project name cannot be empty'
+ * validateProjectName('MyApp') // 'Project name must contain only lowercase letters, numbers, and hyphens'
+ */
+export declare function validateProjectName(name: string): true | string;

package/dist/utils/path-utils.js

@@ -0,0 +1,99 @@
+/**
+ * Utility functions for path handling and project name derivation
+ */
+import path from 'node:path';
+/**
+ * Converts a string to kebab-case
+ *
+ * @param str - The string to convert
+ * @returns The kebab-cased string
+ *
+ * @example
+ * toKebabCase('MyApp') // 'my-app'
+ * toKebabCase('my_app') // 'my-app'
+ * toKebabCase('My App!') // 'my-app'
+ * toKebabCase('my--app') // 'my-app'
+ */
+export function toKebabCase(str) {
+    return (str
+        .trim()
+        // Remove special characters except spaces, underscores, and hyphens
+        .replace(/[^a-zA-Z0-9\s_-]/g, '')
+        // Replace spaces and underscores with hyphens
+        .replace(/[\s_]+/g, '-')
+        // Insert hyphen before uppercase letters preceded by lowercase
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        // Convert to lowercase
+        .toLowerCase()
+        // Replace multiple consecutive hyphens with single hyphen
+        .replace(/-+/g, '-')
+        // Remove leading/trailing hyphens
+        .replace(/^-+|-+$/g, ''));
+}
+/**
+ * Derives a project name from a given path
+ *
+ * @param projectPath - The path to derive the name from
+ * @param currentWorkingDirectory - The current working directory (defaults to process.cwd())
+ * @returns The derived project name in kebab-case
+ *
+ * @example
+ * deriveProjectName('my-project') // 'my-project'
+ * deriveProjectName('apps/MyApp') // 'my-app'
+ * deriveProjectName('./', '/Users/test/MyProject') // 'my-project'
+ * deriveProjectName('../parent') // 'parent'
+ * deriveProjectName('/absolute/path/to/app') // 'app'
+ */
+export function deriveProjectName(projectPath, currentWorkingDirectory = process.cwd()) {
+    // Resolve the path to handle relative paths
+    const resolvedPath = path.resolve(currentWorkingDirectory, projectPath);
+    // Get the last segment of the path
+    const basename = path.basename(resolvedPath);
+    // Convert to kebab-case
+    return toKebabCase(basename);
+}
+/**
+ * Resolves a project path and derives the name
+ *
+ * @param projectPath - The path to resolve
+ * @param currentWorkingDirectory - The current working directory (defaults to process.cwd())
+ * @returns An object containing the resolved path and derived name
+ *
+ * @example
+ * resolveProjectPathAndName('apps/MyApp')
+ * // { resolvedPath: '/Users/user/cwd/apps/MyApp', derivedName: 'my-app' }
+ */
+export function resolveProjectPathAndName(projectPath, currentWorkingDirectory = process.cwd()) {
+    const resolvedPath = path.resolve(currentWorkingDirectory, projectPath);
+    const derivedName = deriveProjectName(projectPath, currentWorkingDirectory);
+    return { resolvedPath, derivedName };
+}
+/**
+ * Validates a project name according to npm package name requirements
+ *
+ * @param name - The project name to validate
+ * @returns true if valid, or an error message string if invalid
+ *
+ * @example
+ * validateProjectName('my-app') // true
+ * validateProjectName('') // 'Project name cannot be empty'
+ * validateProjectName('MyApp') // 'Project name must contain only lowercase letters, numbers, and hyphens'
+ */
+export function validateProjectName(name) {
+    if (!name || name.length === 0) {
+        return 'Project name cannot be empty';
+    }
+    if (name.length > 214) {
+        return 'Project name must be 214 characters or less';
+    }
+    if (name.startsWith('.') || name.startsWith('_')) {
+        return 'Project name cannot start with . or _';
+    }
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        return 'Project name must contain only lowercase letters, numbers, and hyphens';
+    }
+    if (name.startsWith('-') || name.endsWith('-')) {
+        return 'Project name cannot start or end with a hyphen';
+    }
+    return true;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetryos/cli",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "The official TelemetryOS application CLI package. Use it to build applications that run on the TelemetryOS platform",
   "type": "module",
   "bin": {
@@ -25,11 +25,13 @@
   "license": "",
   "repository": "github:TelemetryTV/Application-API",
   "dependencies": {
-    "@telemetryos/development-application-host-ui": "^1.9.0",
+    "@telemetryos/development-application-host-ui": "^1.11.0",
     "@types/serve-handler": "^6.1.4",
     "commander": "^14.0.0",
+    "ignore": "^6.0.2",
     "inquirer": "^12.9.6",
     "serve-handler": "^6.1.6",
+    "tar": "^7.4.3",
     "zod": "^4.1.12"
   },
   "devDependencies": {

package/templates/vite-react-typescript/CLAUDE.md

@@ -13,8 +13,11 @@ tos serve          # Start dev server (or: npm run dev)
 **IMPORTANT:** Always run `npm run build` after making changes to check for TypeScript errors. Do not rely solely on the dev server.
 
 **Development Host:** http://localhost:2026
-- Settings: http://localhost:2026/settings
-- Render: http://localhost:2026/render
+Both the render and settings mounts points are visible in the development host.
+The Render mount point is presented in a resizable pane.
+The Settings mount point shows in the right sidebar.
+
+**The development host is already running!** The user has already started it and the agent doesn't need to run it
 
 ## Architecture
 
@@ -99,15 +102,20 @@ const response = await proxy().fetch('https://api.example.com/data')
 
 **IMPORTANT:** You MUST invoke the relevant skill BEFORE writing code for these tasks:
 
+**For Render views:** ALWAYS read `tos-render-ui-design` first, then the appropriate specialized skill.
+
 | Task | Required Skill | Why |
 |------|----------------|-----|
-| Building Render views | `tos-render-design` | Digital signage constraints, UI scaling, no hover/scroll |
+| Starting new project | `tos-requirements` | Gather requirements before coding MUST USE |
+| Building ANY Render view | `tos-render-ui-design` | UI scaling foundation - ALWAYS read first |
+| Building digital signage | `tos-render-signage-design` | Display-only patterns (no interaction) |
+| Building interactive kiosk | `tos-render-kiosk-design` | Touch interaction, idle timeout, navigation |
 | Adding ANY Settings UI | `tos-settings-ui` | SDK components are required - raw HTML won't work |
-| Calling external APIs | `tos-proxy-fetch` | Proxy patterns prevent CORS errors |
 | Adding store keys | `tos-store-sync` | Hook patterns ensure Settings↔Render sync |
-| Weather integration | `tos-weather-api` | API-specific patterns and credentials |
+| Building multi-mode apps | `tos-multi-mode` | Entity-scoped data, mode switching, namespace patterns |
+| Calling external APIs | `tos-proxy-fetch` | Proxy patterns prevent CORS errors |
 | Media library access | `tos-media-api` | SDK media methods and types |
-| Starting new project | `tos-requirements` | Gather requirements before coding |
+| Weather integration | `tos-weather-api` | API-specific patterns and credentials |
 | Debugging issues | `tos-debugging` | Common errors and fixes |
 
 **Never write Render layouts, Settings components, or proxy.fetch code without invoking the skill first.**

package/templates/vite-react-typescript/_claude/skills/tos-architecture/SKILL.md

@@ -232,15 +232,11 @@ export function App() {
 
 ### Local Development
 
-```bash
-# Start dev server
-tos serve
-# Or: npm run dev
+**Development Host:** http://localhost:2026
+Both the render and settings mounts points are visible in the development host.
+The Render mount point is presented in a resizable pane.
+The Settings mount point shows in the right sidebar.
 
-# Access locally:
-# Settings: http://localhost:3000/settings
-# Render:   http://localhost:3000/render
-```
 
 ### Build & Deploy
 
@@ -255,26 +251,6 @@ git add . && git commit -m "Update" && git push
 
 ## Common Patterns
 
-### Check Mount Point
-
-```typescript
-const isSettings = window.location.pathname === '/settings'
-const isRender = window.location.pathname === '/render'
-```
-
-### Conditional Features
-
-```typescript
-// In a shared component
-const isRender = window.location.pathname === '/render'
-
-// Only fetch external data in Render
-useEffect(() => {
-  if (!isRender) return
-  fetchExternalData()
-}, [isRender])
-```
-
 ### Handle Missing Config
 
 ```typescript