npm - @codeyam/codeyam-cli - Versions diffs - 0.1.0-staging.415103 → 0.1.0-staging.44b55c1 - Mend

@codeyam/codeyam-cli 0.1.0-staging.415103 → 0.1.0-staging.44b55c1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (320) hide show

package/codeyam-cli/templates/chrome-extension-react/popup.html ADDED Viewed

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>CodeYam App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/popup/main.tsx"></script>
+  </body>
+</html>

package/codeyam-cli/templates/chrome-extension-react/public/manifest.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "manifest_version": 3,
+  "name": "CodeYam App",
+  "version": "0.1.0",
+  "description": "Built with CodeYam Editor",
+  "action": {
+    "default_popup": "popup.html",
+    "default_title": "CodeYam App"
+  },
+  "permissions": ["storage"],
+  "background": {
+    "service_worker": "background.js",
+    "type": "module"
+  }
+}

package/codeyam-cli/templates/chrome-extension-react/src/background/service-worker.ts ADDED Viewed

@@ -0,0 +1,7 @@
+// Background service worker for the Chrome extension.
+// This runs in the background and can handle events like
+// extension install, alarms, messages from popup/content scripts, etc.
+chrome.runtime.onInstalled.addListener(() => {
+  console.log('Extension installed');
+});

package/codeyam-cli/templates/chrome-extension-react/src/globals.css ADDED Viewed

@@ -0,0 +1,6 @@
+@import "tailwindcss";
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+}

package/codeyam-cli/templates/chrome-extension-react/src/lib/storage.ts ADDED Viewed

@@ -0,0 +1,37 @@
+// Wrapper around chrome.storage.local for type-safe data persistence.
+// Falls back to localStorage when running in a regular browser (during development).
+//
+// Usage:
+//   import { storage } from "@/lib/storage";
+//   await storage.get<Todo[]>("todos", []);
+//   await storage.set("todos", updatedTodos);
+const isChromeExtension =
+  typeof chrome !== 'undefined' && chrome.storage?.local;
+export const storage = {
+  async get<T>(key: string, defaultValue: T): Promise<T> {
+    if (isChromeExtension) {
+      const result = await chrome.storage.local.get(key);
+      return (result[key] as T) ?? defaultValue;
+    }
+    const item = localStorage.getItem(key);
+    return item ? (JSON.parse(item) as T) : defaultValue;
+  },
+  async set<T>(key: string, value: T): Promise<void> {
+    if (isChromeExtension) {
+      await chrome.storage.local.set({ [key]: value });
+      return;
+    }
+    localStorage.setItem(key, JSON.stringify(value));
+  },
+  async remove(key: string): Promise<void> {
+    if (isChromeExtension) {
+      await chrome.storage.local.remove(key);
+      return;
+    }
+    localStorage.removeItem(key);
+  },
+};

package/codeyam-cli/templates/chrome-extension-react/src/popup/App.tsx ADDED Viewed

@@ -0,0 +1,12 @@
+export default function App() {
+  return (
+    <main className="w-80 min-h-48 p-4 flex items-center justify-center">
+      <div className="text-center">
+        <h1 className="text-xl font-bold mb-2">Welcome</h1>
+        <p className="text-gray-600 text-sm">
+          Your extension is ready. Start building!
+        </p>
+      </div>
+    </main>
+  );
+}

package/codeyam-cli/templates/chrome-extension-react/src/popup/main.tsx ADDED Viewed

@@ -0,0 +1,10 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import '../globals.css';
+import App from './App';
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/codeyam-cli/templates/chrome-extension-react/tsconfig.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src"]
+}

package/codeyam-cli/templates/chrome-extension-react/vite.config.ts ADDED Viewed

@@ -0,0 +1,41 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import tailwindcss from '@tailwindcss/vite';
+import { resolve } from 'path';
+// In "extension" mode, build produces a Chrome extension in dist/.
+// In default mode, `vite dev` serves the popup as a regular web page
+// so you can develop and test it in a normal browser tab.
+export default defineConfig(({ mode }) => ({
+  plugins: [react(), tailwindcss()],
+  server: {
+    // Bind to the port provided by CodeYam editor (via PORT env var) or default 5173.
+    // Use 0.0.0.0 so the dev server is reachable on both IPv4 and IPv6 loopback.
+    port: process.env.PORT ? parseInt(process.env.PORT, 10) : 5173,
+    host: '0.0.0.0',
+  },
+  resolve: {
+    alias: {
+      '@': resolve(__dirname, 'src'),
+    },
+  },
+  build:
+    mode === 'extension'
+      ? {
+          rollupOptions: {
+            input: {
+              popup: resolve(__dirname, 'popup.html'),
+            },
+            output: {
+              entryFileNames: '[name].js',
+              chunkFileNames: '[name].js',
+              assetFileNames: '[name].[ext]',
+            },
+          },
+          outDir: 'dist',
+          emptyOutDir: true,
+          copyPublicDir: true,
+        }
+      : undefined,
+}));

package/codeyam-cli/templates/editor-step-hook.py CHANGED Viewed

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 """
-PostToolUse + Stop hook for editor mode step tracking.
+PostToolUse + Stop + UserPromptSubmit hook for editor mode step tracking.
 Reads .codeyam/editor-step.json and prints a reminder about the current step.
 Logs each firing to .codeyam/logs/editor-log.jsonl.
@@ -18,25 +18,31 @@ STEP_LABELS = {
     2: "Prototype",
     3: "Confirm",
     4: "Deconstruct",
-    5: "Glossary",
-    6: "Analyze",
-    7: "App Scenarios",
-    8: "User Scenarios",
-    9: "Verify",
-    10: "Review",
+    5: "Extract",
+    6: "Glossary",
+    7: "Analyze",
+    8: "App Scenarios",
+    9: "User Scenarios",
+    10: "Verify",
+    11: "Journal",
+    12: "Review",
+    13: "Present",
 }
 STEP_RESTRICTIONS = {
     1: "Do NOT write any code. Plan and describe only. Wait for user confirmation.",
     2: "Do NOT create scenarios or run codeyam analyze. Build fast — working prototype with real data.",
     3: "Present a selection menu (AskUserQuestion) for confirmation. Do NOT refactor or create scenarios until approved.",
-    4: "Do NOT create scenarios. Write a failing test FIRST, then extract. TDD only.",
-    5: "Do NOT write application code or scenarios. Update the glossary only.",
-    6: "Run codeyam analyze for each file. Verify all pass. Fix any failures before proceeding.",
-    7: "Do NOT modify application code. Create and register app-level scenarios only.",
-    8: "Do NOT modify application code. Create user-persona scenarios only (or skip if no users).",
-    9: "Verify entity screenshots (/api/editor-entity-status) AND editor scenarios. After ANY code fix, re-run codeyam analyze on affected files. Fix only — do NOT add features.",
-    10: "Verify ALL screenshots exist and NO client-side errors (/api/editor-client-errors), then present selection menu (AskUserQuestion): Save or make changes.",
+    4: "Do NOT write any code. Read every file, identify all extractable pieces, write a numbered plan. Planning only.",
+    5: "Execute the extraction plan from step 4. Components first (no tests), then library functions via TDD. Page files must contain ZERO direct JSX.",
+    6: "Do NOT write application code or scenarios. Update the glossary only.",
+    7: "Create isolation routes for visual components, run tests for library functions. Register component scenarios via codeyam editor register.",
+    8: "Do NOT modify application code. Create and register app-level scenarios only.",
+    9: "Do NOT modify application code. Create user-persona scenarios only (or skip if no users).",
+    10: "Verify component isolation screenshots AND editor scenarios. After ANY code fix, re-register affected components. Fix only — do NOT add features.",
+    11: "Create or update the journal entry for this feature. Do NOT create a duplicate — check if one exists first.",
+    12: "Verify ALL screenshots exist and NO client-side errors (/api/editor-client-errors). Run codeyam editor audit. Do not proceed until all checks pass.",
+    13: "Show the results panel, present summary, then selection menu (AskUserQuestion): Save or make changes.",
 }
@@ -56,17 +62,19 @@ def log_event(project_dir, event, data=None):
 def detect_event():
-    """Detect whether this is a PostToolUse or Stop hook from stdin."""
+    """Detect whether this is a PostToolUse, Stop, or UserPromptSubmit hook from stdin."""
     try:
         raw = sys.stdin.read()
         if not raw.strip():
             return "unknown", {}
         data = json.loads(raw)
-        # PostToolUse has tool_name; Stop has stop_hook_active
+        # PostToolUse has tool_name; Stop has stop_hook_active; UserPromptSubmit has prompt
         if "tool_name" in data:
             return "post_tool_use", data
         elif "stop_hook_active" in data:
             return "stop", data
+        elif "prompt" in data:
+            return "user_prompt", data
         return "unknown", data
     except Exception:
         return "unknown", {}
@@ -75,6 +83,22 @@ def detect_event():
 def main():
     project_dir = os.environ.get("CLAUDE_PROJECT_DIR", os.getcwd())
     state_path = os.path.join(project_dir, ".codeyam", "editor-step.json")
+    prompt_path = os.path.join(project_dir, ".codeyam", "editor-user-prompt.txt")
+    # Detect event early so we can capture the user prompt even before state exists
+    event_type, event_data = detect_event()
+    # Capture the very first user prompt (before state file may exist).
+    # Save to a separate file so it persists across state transitions.
+    if event_type == "user_prompt" and not os.path.exists(prompt_path):
+        prompt_text = event_data.get("prompt", "").strip()
+        if prompt_text:
+            try:
+                os.makedirs(os.path.dirname(prompt_path), exist_ok=True)
+                with open(prompt_path, "w") as f:
+                    f.write(prompt_text)
+            except Exception:
+                pass  # Best-effort
     if not os.path.exists(state_path):
         return
@@ -92,8 +116,6 @@ def main():
     if not step:
         return
-    event_type, event_data = detect_event()
     # Log the hook firing
     log_data = {"step": step, "label": label, "feature": feature, "hook": event_type}
     if event_type == "post_tool_use":
@@ -101,7 +123,52 @@ def main():
     log_event(project_dir, "hook", log_data)
     restriction = STEP_RESTRICTIONS.get(step, "")
-    next_cmd = f"codeyam editor {step + 1}" if step < 10 else "codeyam editor 1"
+    next_cmd = f"codeyam editor {step + 1}" if step < 13 else "codeyam editor 1"
+    # UserPromptSubmit: concise workflow reminder injected before Claude processes the user's message
+    if event_type == "user_prompt":
+        lines = [
+            f'<user-prompt-submit-hook>',
+            f'Editor Mode — Step {step} ({label}): "{feature}"',
+        ]
+        # Include the active scenario so Claude knows what the user is looking at
+        active_scenario_path = os.path.join(project_dir, ".codeyam", "active-scenario.json")
+        try:
+            with open(active_scenario_path, "r") as f:
+                active = json.load(f)
+            scenario_name = (
+                active.get("scenarioName")
+                or active.get("scenarioSlug", "").replace("_", " ")
+            )
+            if scenario_name:
+                lines.append(
+                    f'The user is currently viewing scenario: "{scenario_name}". '
+                    "Assume any feedback refers to this scenario unless they say otherwise."
+                )
+        except (IOError, json.JSONDecodeError):
+            pass
+        if step == 13:
+            lines.append(
+                "If the user is requesting changes (even indirectly), "
+                "run `codeyam editor change` BEFORE making any modifications "
+                "(code, scenarios, data, styles — everything). "
+                "The change command gives you the post-change checklist. "
+                "The change workflow ensures Working Session Results are shown to the user. "
+                "If the user chose to commit, run `codeyam editor steps` after committing "
+                "to start the next feature."
+            )
+        else:
+            lines.append(
+                f"You are on step {step}. Follow the `codeyam editor` workflow. "
+                f"Do NOT skip ahead or make changes outside the current step."
+            )
+        if restriction:
+            lines.append(restriction)
+        lines.append('</user-prompt-submit-hook>')
+        print("\n".join(lines))
+        return
     lines = [
         f'Editor Mode \u2014 Step {step} ({label}): "{feature}"',
@@ -116,7 +183,7 @@ def main():
         DIM = "\033[2m"
         RESET = "\033[0m"
         tracker = [f"{DIM}  \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510{RESET}"]
-        for i in range(1, 11):
+        for i in range(1, 14):
             lbl = STEP_LABELS[i].ljust(28)
             num = f" {i}" if i < 10 else f"{i}"
             content = f"{num}. {lbl}"
@@ -134,6 +201,27 @@ def main():
             "\u2713 (done) or \u2717 (skipped + reason)."
         )
+    if event_type == "stop" and step == 13:
+        import subprocess as _sp
+        try:
+            _result = _sp.run(
+                ["git", "status", "--porcelain"],
+                cwd=project_dir,
+                capture_output=True, text=True, timeout=5
+            )
+            has_uncommitted = bool(_result.stdout.strip())
+        except Exception:
+            has_uncommitted = False
+        if has_uncommitted:
+            lines.append(
+                "\n\033[1;31m⚠️  You have uncommitted changes but haven't shown Working Session Results.\033[0m"
+            )
+            lines.append(
+                "\033[31mRun `codeyam editor change` if you haven't already, then complete the "
+                "checklist and run `codeyam editor 13` to show results to the user.\033[0m"
+            )
     lines.append(f"When this step is complete, run: {next_cmd}")
     print("\n".join(lines))

package/codeyam-cli/templates/expo-react-native/MOBILE_SETUP.md ADDED Viewed

@@ -0,0 +1,89 @@
+# Expo + React Native Setup
+## Development
+This project uses **Expo** with **Expo Router** for file-based navigation and **NativeWind** (Tailwind CSS) for styling.
+### Web Development (used by CodeYam)
+```bash
+npm run dev
+```
+This starts the Expo web dev server. CodeYam uses this to preview your app and take screenshots.
+### Mobile Development
+```bash
+# iOS Simulator
+npm run ios
+# Android Emulator
+npm run android
+# Start Expo dev server (pick platform from menu)
+npm start
+```
+## Project Structure
+```
+app/                    # Expo Router file-based routes
+  _layout.tsx           # Root layout (status bar, navigation)
+  (tabs)/               # Tab-based navigation group
+    _layout.tsx         # Tab bar configuration
+    index.tsx           # Home tab
+    settings.tsx        # Settings tab
+components/             # Reusable components
+lib/
+  storage.ts            # AsyncStorage wrapper for persistent data
+```
+## Key Patterns
+### Navigation (Expo Router)
+Add new screens by creating files in `app/`:
+- `app/profile.tsx` — accessible at `/profile`
+- `app/items/[id].tsx` — dynamic route at `/items/123`
+### Data Fetching
+Use standard `fetch()` for API calls. CodeYam intercepts these to provide mock data during simulations:
+```tsx
+const response = await fetch('/api/items');
+const data = await response.json();
+```
+### Storage
+Use the typed storage helper for persistent data:
+```tsx
+import { storage } from '@/lib/storage';
+const items = await storage.get('items', []);
+await storage.set('items', [...items, newItem]);
+```
+### Styling (NativeWind)
+Use Tailwind classes on React Native components:
+```tsx
+<View className="flex-1 items-center justify-center bg-white p-4">
+  <Text className="text-lg font-bold text-gray-900">Hello</Text>
+</View>
+```
+## Building for Production
+```bash
+# Web
+npm run build:web
+# iOS/Android (requires EAS CLI)
+npx eas build
+```

package/codeyam-cli/templates/expo-react-native/app/(tabs)/_layout.tsx ADDED Viewed

@@ -0,0 +1,33 @@
+import { Tabs } from 'expo-router';
+import { Ionicons } from '@expo/vector-icons';
+export default function TabLayout() {
+  return (
+    <Tabs
+      screenOptions={{
+        tabBarActiveTintColor: '#005C75',
+        headerStyle: { backgroundColor: '#f8fafc' },
+        headerTitleStyle: { fontWeight: '600' },
+      }}
+    >
+      <Tabs.Screen
+        name="index"
+        options={{
+          title: 'Home',
+          tabBarIcon: ({ color, size }) => (
+            <Ionicons name="home-outline" size={size} color={color} />
+          ),
+        }}
+      />
+      <Tabs.Screen
+        name="settings"
+        options={{
+          title: 'Settings',
+          tabBarIcon: ({ color, size }) => (
+            <Ionicons name="settings-outline" size={size} color={color} />
+          ),
+        }}
+      />
+    </Tabs>
+  );
+}

package/codeyam-cli/templates/expo-react-native/app/(tabs)/index.tsx ADDED Viewed

@@ -0,0 +1,12 @@
+import { View, Text } from 'react-native';
+export default function HomeScreen() {
+  return (
+    <View className="flex-1 items-center justify-center bg-white p-6">
+      <Text className="text-2xl font-bold text-gray-900 mb-2">Welcome</Text>
+      <Text className="text-base text-gray-500 text-center">
+        Your Expo app is ready. Start building!
+      </Text>
+    </View>
+  );
+}

package/codeyam-cli/templates/expo-react-native/app/(tabs)/settings.tsx ADDED Viewed

@@ -0,0 +1,12 @@
+import { View, Text } from 'react-native';
+export default function SettingsScreen() {
+  return (
+    <View className="flex-1 items-center justify-center bg-white p-6">
+      <Text className="text-2xl font-bold text-gray-900 mb-2">Settings</Text>
+      <Text className="text-base text-gray-500 text-center">
+        Configure your app preferences here.
+      </Text>
+    </View>
+  );
+}

package/codeyam-cli/templates/expo-react-native/app/_layout.tsx ADDED Viewed

@@ -0,0 +1,12 @@
+import '../global.css';
+import { Stack } from 'expo-router';
+import { StatusBar } from 'expo-status-bar';
+export default function RootLayout() {
+  return (
+    <>
+      <Stack screenOptions={{ headerShown: false }} />
+      <StatusBar style="auto" />
+    </>
+  );
+}

package/codeyam-cli/templates/expo-react-native/app.json ADDED Viewed

@@ -0,0 +1,18 @@
+{
+  "expo": {
+    "name": "CodeYam Expo App",
+    "slug": "codeyam-expo-app",
+    "version": "1.0.0",
+    "scheme": "codeyam-expo-app",
+    "platforms": ["ios", "android", "web"],
+    "web": {
+      "bundler": "metro",
+      "output": "single",
+      "favicon": "./assets/favicon.png"
+    },
+    "plugins": ["expo-router"],
+    "experiments": {
+      "typedRoutes": true
+    }
+  }
+}

package/codeyam-cli/templates/expo-react-native/babel.config.js ADDED Viewed

@@ -0,0 +1,9 @@
+module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: [
+      ['babel-preset-expo', { jsxImportSource: 'nativewind' }],
+      'nativewind/babel',
+    ],
+  };
+};

package/codeyam-cli/templates/expo-react-native/gitignore ADDED Viewed

@@ -0,0 +1,12 @@
+node_modules/
+.expo/
+dist/
+web-build/
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+*.orig.*
+.env
+.env.local

package/codeyam-cli/templates/expo-react-native/global.css ADDED Viewed

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

package/codeyam-cli/templates/expo-react-native/lib/storage.ts ADDED Viewed

@@ -0,0 +1,32 @@
+import AsyncStorage from '@react-native-async-storage/async-storage';
+/**
+ * Type-safe storage abstraction over AsyncStorage.
+ * Works on iOS, Android, and Web.
+ */
+export const storage = {
+  async get<T>(key: string, defaultValue: T): Promise<T> {
+    try {
+      const raw = await AsyncStorage.getItem(key);
+      return raw !== null ? JSON.parse(raw) : defaultValue;
+    } catch {
+      return defaultValue;
+    }
+  },
+  async set<T>(key: string, value: T): Promise<void> {
+    try {
+      await AsyncStorage.setItem(key, JSON.stringify(value));
+    } catch {
+      // Storage write failed silently
+    }
+  },
+  async remove(key: string): Promise<void> {
+    try {
+      await AsyncStorage.removeItem(key);
+    } catch {
+      // Storage remove failed silently
+    }
+  },
+};

package/codeyam-cli/templates/expo-react-native/metro.config.js ADDED Viewed

@@ -0,0 +1,6 @@
+const { getDefaultConfig } = require('expo/metro-config');
+const { withNativeWind } = require('nativewind/metro');
+const config = getDefaultConfig(__dirname);
+module.exports = withNativeWind(config, { input: './global.css' });

package/codeyam-cli/templates/expo-react-native/nativewind-env.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ /// <reference types="nativewind/types" />

package/codeyam-cli/templates/expo-react-native/package.json ADDED Viewed

@@ -0,0 +1,37 @@
+{
+  "name": "codeyam-expo-app",
+  "version": "0.1.0",
+  "private": true,
+  "main": "expo-router/entry",
+  "scripts": {
+    "dev": "expo start --web",
+    "start": "expo start",
+    "android": "expo start --android",
+    "ios": "expo start --ios",
+    "build:web": "expo export --platform web"
+  },
+  "dependencies": {
+    "expo": "~55.0.5",
+    "expo-router": "~55.0.4",
+    "expo-status-bar": "~55.0.4",
+    "expo-linking": "~55.0.7",
+    "expo-constants": "~55.0.7",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "react-native": "0.83.2",
+    "react-native-web": "^0.21.0",
+    "react-native-safe-area-context": "~5.6.2",
+    "react-native-screens": "~4.23.0",
+    "@react-navigation/native": "^7.1.33",
+    "@expo/vector-icons": "^15.0.2",
+    "@react-native-async-storage/async-storage": "2.2.0",
+    "nativewind": "^4.2.2",
+    "tailwindcss": "^3.4.19",
+    "react-native-reanimated": "4.2.1"
+  },
+  "devDependencies": {
+    "@types/react": "~19.2.2",
+    "babel-preset-expo": "^55.0.10",
+    "typescript": "~5.9.2"
+  }
+}