ucode-agent 1.4.0 → 1.6.0

package/src/ui/screen.js

@@ -41,6 +41,7 @@ import {
   boxTop, boxBottom, boxRow, visLen, padVis, clip, wrapAnsi,
   shortenPath, asLabel, ensureColour, planLine, bare,
 } from './theme.js';
+import { FRAME_MS, fitActivity, shimmer, spinnerGlyph, formatDuration, doneLine, stepPaint } from './activity.js';
 import { renderer, render, polish } from './markdown.js';
 import { VERSION } from '../core/version.js';
 
@@ -58,6 +59,7 @@ export function isLabel(text) {
 export const COMMANDS = [
   '/help', '/model', '/models', '/session', '/sessions', '/resume',
   '/new', '/remember', '/skills', '/clear', '/search', '/copy', '/exit',
+  '/stats', '/doctor', '/deploy',
 ];
 
 // ANSI ----------------------------------------------------------------------
@@ -135,6 +137,8 @@ export class Screen {
     this.onInterrupt = null;
     this.onModeChange = null;
     this.spinTimer = null;
+    this.activity = null; // the turn in flight: when it began, how many steps
+    this.tick = 0;        // animation frames painted, for the spinner
     this.pendingPrompt = null;
 
     this.cols = output.columns || 80;
@@ -164,7 +168,9 @@ export class Screen {
   }
 
   stop() {
+    this.activity = null;
     this.stopSpinner();
+    this.stopTimer();
     this.output.off?.('resize', this.onResize);
     this.input.setRawMode?.(false);
     this.input.pause();
@@ -633,14 +639,23 @@ export class Screen {
     let middle = '';
     if (this.flashText) {
       middle = dim(clip(this.flashText, between - 2));
-    } else if (this.status.busy) {
-      const frame = blue(SPINNER[this.status.frame]);
-      const secs = Math.round((Date.now() - (this.status.since || Date.now())) / 1000);
-      const elapsed = secs >= 2 ? dim(` ${secs}s`) : '';
-      const room = between - 20;
-      middle = room > 8
-        ? `${frame} ${dim(clip(this.status.text, room))}${elapsed}  ${dim('esc to stop')}`
-        : `${frame}${elapsed}`;
+    } else if (this.status.busy || this.activity) {
+      // The whole turn, not just the current tool: the timer and step count
+      // keep going through the gaps between calls, so a long build never
+      // looks like it has stopped.
+      const now = Date.now();
+      const a = this.activity;
+      const since = a?.start ?? this.status.since ?? now;
+      const meta = [];
+      if (a?.steps) meta.push({ text: `step ${a.steps}`, paint: stepPaint(now - a.movedAt < 900) });
+      if (now - since >= 1000) meta.push({ text: formatDuration(now - since), keep: true });
+      middle = fitActivity({
+        glyph: spinnerGlyph(this.tick, now),
+        label: this.status.busy ? this.status.text : 'working',
+        meta,
+        hint: 'esc to stop',
+        paint: (s) => shimmer(s, now),
+      }, between - 3);
     }
 
     // The percentage is pinned to the right border whatever is in the middle,
@@ -700,13 +715,7 @@ export class Screen {
     // `since` is what makes a long think legible: the label may not change for
     // a minute, so the seconds beside it are the proof it is still alive.
     this.status = { busy: true, text: asLabel(text), frame: 0, since: Date.now() };
-    if (!this.spinTimer) {
-      this.spinTimer = setInterval(() => {
-        this.status.frame = (this.status.frame + 1) % SPINNER.length;
-        this.paintStatus();
-      }, 80);
-      this.spinTimer.unref?.();
-    }
+    this.startTimer();
     this.paintStatus();
   }
 
@@ -717,16 +726,53 @@ export class Screen {
   }
 
   stopSpinner() {
-    if (this.spinTimer) {
-      clearInterval(this.spinTimer);
-      this.spinTimer = null;
-    }
+    if (!this.activity) this.stopTimer();
     if (this.status.busy) {
       this.status = { busy: false, text: '', frame: 0, since: 0 };
       this.paintStatus();
     }
   }
 
+  // -- the turn in flight ----------------------------------------------------
+
+  /** A turn begins: the timer and step count run until turnEnd(). */
+  turnStart() {
+    this.activity = { start: Date.now(), steps: 0, movedAt: 0 };
+    this.startTimer();
+  }
+
+  /** One more model step in this turn. */
+  step() {
+    if (!this.activity) return;
+    this.activity.steps++;
+    this.activity.movedAt = Date.now();
+  }
+
+  /** The turn is over: leave "✓ Done in 6m 12s · 25 steps" under the answer. */
+  turnEnd({ ok = true } = {}) {
+    const a = this.activity;
+    this.activity = null;
+    if (!this.status.busy) this.stopTimer();
+    if (a && ok && Date.now() - a.start >= 2000) this.push(`  ${doneLine(Date.now() - a.start, a.steps)}`);
+    this.paintStatus();
+  }
+
+  /** The animation clock: only the status row repaints, about twelve times a second. */
+  startTimer() {
+    if (this.spinTimer) return;
+    this.spinTimer = setInterval(() => {
+      this.tick++;
+      this.paintStatus();
+    }, FRAME_MS);
+    this.spinTimer.unref?.();
+  }
+
+  stopTimer() {
+    if (!this.spinTimer) return;
+    clearInterval(this.spinTimer);
+    this.spinTimer = null;
+  }
+
   // -- input ---------------------------------------------------------------
 
   nextLine() {

package/templates/next-shadcn/AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

package/templates/next-shadcn/README.md

@@ -0,0 +1,9 @@
+# __APP_NAME__
+
+Built with ucode on Next.js and shadcn/ui.
+
+```bash
+npm run dev
+```
+
+Then open http://localhost:3000

package/templates/next-shadcn/TEMPLATE.md

@@ -0,0 +1,83 @@
+# What this project already has
+
+It was created by ucode's `create_app` from a starter that is known to build.
+Do not re-run create-next-app or `shadcn init` — everything below is in place.
+
+## Stack
+
+- Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4
+- shadcn/ui on Radix (the standard shadcn you know — `asChild` works), lucide-react icons
+- next-themes (light / dark / system), sonner toasts, date-fns, react-day-picker
+
+Next 16 changed some APIs. `AGENTS.md` explains, and `node_modules/next/dist/docs/`
+has the guides — check them before using an API you are unsure of.
+
+## Already wired
+
+- `src/app/layout.tsx` — font (Geist, registered as `--font-sans`), `ThemeProvider`,
+  `TooltipProvider`, and `<Toaster />`.
+- `src/components/theme-toggle.tsx` — a light/dark button, ready to place.
+- `src/app/globals.css` — the design tokens. The palette is a starting point:
+  re-tint `--primary`, `--accent` and the neutrals for this app's direction.
+  `--success` and `--warning` exist alongside `--destructive`
+  (`bg-success`, `text-warning`, ...).
+- `src/app/page.tsx` — a placeholder. Replace it.
+
+`layout.tsx`, `theme-provider.tsx`, `theme-toggle.tsx`, `src/lib/utils.ts` and
+everything in `src/components/ui/` are finished and build. Use them; do not
+rewrite them — a rewrite from memory brings back APIs that no longer exist.
+
+## Components in `src/components/ui/`
+
+accordion, alert-dialog, avatar, badge, button, calendar, card, checkbox, collapsible, command, dialog, dropdown-menu, hover-card, input-group, input, label, popover, progress, radio-group, scroll-area, select, separator, sheet, skeleton, slider, sonner, switch, table, tabs, textarea, toggle-group, toggle, tooltip
+
+Anything else: `npx shadcn@latest add <name> -y` with cwd set to this folder.
+
+## APIs that are easy to get wrong
+
+```tsx
+// Toasts — sonner. A message first, options second. There is no toast({ title }).
+import { toast } from "sonner";
+toast.success("Saved");
+toast("Task deleted", { description: "Buy milk", action: { label: "Undo", onClick: () => restore() } });
+
+// Slider — value is an ARRAY, even for one thumb.
+<Slider value={[tip]} onValueChange={([v]) => setTip(v)} min={0} max={30} step={1} />
+
+// Select — value is a string.
+<Select value={list} onValueChange={(v: string) => setList(v)}>
+  <SelectTrigger><SelectValue placeholder="Pick a list" /></SelectTrigger>
+  <SelectContent><SelectItem value="inbox">Inbox</SelectItem></SelectContent>
+</Select>
+
+// Date picker — Calendar inside a Popover.
+<Popover>
+  <PopoverTrigger asChild><Button variant="outline">{date ? format(date, "PPP") : "Pick a date"}</Button></PopoverTrigger>
+  <PopoverContent className="w-auto p-0"><Calendar mode="single" selected={date} onSelect={setDate} /></PopoverContent>
+</Popover>
+
+// Toggle group — value is a string for type="single".
+<ToggleGroup type="single" value={preset} onValueChange={(v) => v && setPreset(v)}>
+  <ToggleGroupItem value="15">15%</ToggleGroupItem>
+</ToggleGroup>
+
+// Anything using useState, events, localStorage or browser APIs needs "use client"
+// as the first line of its file.
+
+// localStorage — read it in useEffect, never in render or a useState initializer:
+// the page is also rendered on the server, where localStorage does not exist.
+const [bill, setBill] = useState("");
+useEffect(() => { setBill(localStorage.getItem("bill") ?? ""); }, []);
+useEffect(() => { localStorage.setItem("bill", bill); }, [bill]);
+
+// next-themes — there is no "next-themes/dist/types". Import from "next-themes".
+```
+
+## Conventions
+
+- Components are named exports — `export function BillInput()` — imported with
+  braces: `import { BillInput } from "@/components/calculator/bill-input"`.
+  Only `page.tsx` and `layout.tsx` use `export default`.
+- One component per file, grouped by feature: `src/components/<feature>/`.
+- Shared types in `src/lib/types.ts`, helpers in `src/lib/`.
+- `cn()` from `@/lib/utils` to merge class names.

package/templates/next-shadcn/_gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts