frontend-harness 0.7.6 → 0.7.7

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to `frontend-harness` are documented here.
 
 This project follows semver while it is pre-1.0: patch releases may include harness policy improvements that tighten validation, and minor releases may change generated protocol expectations.
 
+## 0.7.7 - 2026-05-26
+
+### Changed
+
+- Reframed the Vue scaffold as a general Vue application baseline instead of an admin-oriented template, with admin shells, menus, permissions, and table-page workflows documented as optional recipes.
+- Strengthened the default Vue scaffold with product-neutral utility, storage, HTTP client, reset, and utility-style layers inspired by mature Vue projects while avoiding Element Plus style variants.
+- Added `.env.example` and typed `VITE_API_BASE_URL` support to the Vue scaffold, tightened generated dependency ranges, and verified generated projects through lint, typecheck, test, and build.
+
 ## 0.7.6 - 2026-05-25
 
 ### Changed

package/README.md

@@ -136,7 +136,7 @@ npm run harness:clean
 
 Use `init` after installation or package upgrades. Use `protocol check` when you want to verify that `AGENTS.md` and `CLAUDE.md` are current. Use `clean` to remove ignored runtime artifacts while preserving durable project skills, knowledge, and config.
 
-`scaffold --preset vue` creates a Vue 3 + Vite + TypeScript engineering baseline inspired by the company `freight-admin` stack. It includes Vite config, ESLint/Prettier, Element Plus auto imports, and small `utils`, `storage`, and `service` layers. It intentionally does not create admin pages, routes, dashboards, permissions, or business components.
+`scaffold --preset vue` creates a general Vue 3 + Vite + TypeScript engineering baseline. It includes Vite config, ESLint/Prettier, Element Plus auto imports, product-neutral style layers, and small `utils`, `storage`, and `service` layers. Mature internal Vue applications can inform the baseline, but the default scaffold is not an admin template and does not create dashboards, sidebars, permission systems, business pages, or domain components. Admin-style shells, table pages, route permissions, and menu trees belong in optional recipes rather than the default preset.
 
 UI restoration work treats design exports, screenshots, and generated code as source evidence for implementation and loop repair, not as paperwork to backfill after coding. For design-backed restoration, visual equivalence is the highest priority for the first project implementation: source material does not mean the agent may redesign the screen. When design_to_code or generated design markup is available, preserve it and classify whether it is usable_as_visual_baseline, usable_for_patch_reference, usable_as_source, or unusable before deciding whether it can seed implementation or only guide repair; verify enforces that classification through visual-baseline metadata for design_to_code sources, and temporary asset localization is required only when the generated artifact is used as project source. Project-native rewrites may change file placement, framework integration, semantic markup, asset localization, naming, state wiring, and component boundaries only when the rendered result preserves the design's primary layout, spacing, typography, color, density, hierarchy, and visible states. When a design contains images, classify each one as required content, functional UI element, brand/product asset, decorative sample, or replaceable placeholder before implementation. Required images should become durable assets; decorative samples and placeholders should be replaced or documented in design evidence. Final handoff evidence should include a restoration verdict with score or pass/fail judgement, key visual differences, accepted gaps, and links to evidence artifacts. Component splits should follow semantic responsibility, reuse, and interaction boundaries rather than mirroring every design layer as a component.
 

package/dist/runtime/scaffold/vue-template.js

@@ -4,6 +4,7 @@ const VUE_TEMPLATE_ROOT = new URL("../../../templates/scaffold/vue/", import.met
 const VUE_TEMPLATE_FILES = [
     { source: "gitignore.tpl", target: ".gitignore" },
     { source: ".husky/pre-commit", target: ".husky/pre-commit", mode: 0o755 },
+    { source: "env.example.tpl", target: ".env.example" },
     { source: "eslint.config.mjs", target: "eslint.config.mjs" },
     { source: "index.html.tpl", target: "index.html" },
     { source: "postcss.config.mjs", target: "postcss.config.mjs" },
@@ -16,7 +17,9 @@ const VUE_TEMPLATE_FILES = [
     { source: "src/env.d.ts", target: "src/env.d.ts" },
     { source: "src/features/home/HomeView.vue", target: "src/features/home/HomeView.vue" },
     { source: "src/styles/main.scss", target: "src/styles/main.scss" },
+    { source: "src/styles/reset.scss", target: "src/styles/reset.scss" },
     { source: "src/styles/tokens.scss", target: "src/styles/tokens.scss" },
+    { source: "src/styles/utilities.scss", target: "src/styles/utilities.scss" },
     { source: "src/utils/index.ts", target: "src/utils/index.ts" },
     { source: "src/storage/index.ts", target: "src/storage/index.ts" },
     { source: "src/service/http.ts", target: "src/service/http.ts" },
@@ -90,18 +93,18 @@ function packageJson(projectName) {
             "eslint-plugin-vue": "^10.6.2",
             "frontend-harness": `^${currentHarnessVersion()}`,
             husky: "^9.1.7",
-            jsdom: "^29.1.1",
+            jsdom: "~25.0.1",
             "lint-staged": "^15.5.2",
             postcss: "^8.4.47",
             prettier: "^3.3.3",
-            sass: "^1.93.2",
+            sass: "~1.93.2",
             typescript: "^5.7.0",
             "unplugin-auto-import": "^19.0.0",
             "unplugin-vue-components": "^28.0.0",
             "vue-eslint-parser": "^10.2.0",
             "vue-tsc": "^3.0.7",
-            vite: "^5.4.21",
-            vitest: "^4.1.6"
+            vite: "~5.4.21",
+            vitest: "~2.1.9"
         },
         "lint-staged": {
             "src/**/*.{ts,vue}": [

package/dist/runtime/scaffold/vue-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue-template.js","sourceRoot":"","sources":["../../../src/runtime/scaffold/vue-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vue-template.js","sourceRoot":"","sources":["../../../src/runtime/scaffold/vue-template.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-harness",
-  "version": "0.7.6",
+  "version": "0.7.7",
   "type": "module",
   "files": [
     "dist",

package/templates/scaffold/vue/README.md.tpl

@@ -1,9 +1,9 @@
 # {{projectName}}
 
-Vue 3 + Vite engineering scaffold.
+Vue 3 + Vite application scaffold.
 
-This preset is based on the company Vue stack shape used in freight-admin, but it only includes engineering infrastructure.
-It intentionally avoids business pages, admin routes, dashboards, permissions, and domain components.
+This preset provides a general Vue engineering baseline. It includes project infrastructure and small reusable layers, but it is not an admin-management template.
+Use mature internal Vue applications as references for proven patterns, then pull admin shells, table pages, menus, route permissions, and business workflows in as project-specific recipes only when the application needs them.
 
 ## Scripts
 
@@ -20,17 +20,24 @@ It intentionally avoids business pages, admin routes, dashboards, permissions, a
 - `npm run harness:check`
 - `npm run harness:clean`
 
-## Base layers
+## Base Layers
 
 - `src/utils` for shared helpers
 - `src/storage` for browser storage wrappers
-- `src/service` for API client setup
-- `src/styles` for project-wide styles
+- `src/service` for configurable API client setup, token injection hooks, blob passthrough, and normalized errors
+- `src/styles` for project-wide style layers
 - `src/styles/tokens.scss` for reusable UI restoration tokens
-- `src/features/<feature>` for page-specific types, fixtures, columns, calculations, and components
+- `src/styles/reset.scss` for browser reset rules
+- `src/styles/utilities.scss` for small, product-neutral utility classes
+- `src/features/<feature>` for feature-local views, types, fixtures, calculations, and components
 - `tests/integration` for Vitest + Testing Library behavior tests
 - `tests/e2e` for Playwright browser smoke tests
 
+## Optional Recipes
+
+Admin layouts, side navigation, menu trees, route permissions, searchable tables, and pagination shells are intentionally outside this default preset.
+Add those as project recipes or feature templates when the product is actually an admin-style application.
+
 ## UI restoration workflow
 
 Use the injected `ui-implementation` project skill and `.frontend-harness/guidance/latest.md` for the current harness plan.

package/templates/scaffold/vue/env.example.tpl

@@ -0,0 +1 @@
+VITE_API_BASE_URL=/api

package/templates/scaffold/vue/eslint.config.mjs

@@ -15,9 +15,11 @@ export default [
     languageOptions: {
       globals: {
         document: "readonly",
+        clearTimeout: "readonly",
         localStorage: "readonly",
         sessionStorage: "readonly",
         Storage: "readonly",
+        setTimeout: "readonly",
         window: "readonly"
       }
     }
@@ -30,6 +32,9 @@ export default [
         ecmaVersion: "latest",
         sourceType: "module"
       }
+    },
+    rules: {
+      "no-unused-vars": "off"
     }
   },
   {

package/templates/scaffold/vue/src/env.d.ts

@@ -1,7 +1,15 @@
 /// <reference types="vite/client" />
 
+interface ImportMetaEnv {
+  readonly VITE_API_BASE_URL?: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+
 declare module "*.vue" {
   import type { DefineComponent } from "vue";
-  const component: DefineComponent<{}, {}, any>;
+  const component: DefineComponent<Record<string, never>, Record<string, never>, unknown>;
   export default component;
 }

package/templates/scaffold/vue/src/features/home/HomeView.vue

@@ -1,10 +1,10 @@
 <template>
   <main class="app-shell">
     <section class="hero">
-      <p class="eyebrow">Vue scaffold</p>
-      <h1>Engineering base is ready</h1>
+      <p class="eyebrow">Vue application</p>
+      <h1>Project foundation is ready</h1>
       <p class="lead">
-        This scaffold carries the company Vue engineering baseline: Vite, TypeScript, Element Plus, auto imports, storage, utility, and service layers.
+        This scaffold gives the project a neutral Vue foundation: Vite, TypeScript, Element Plus, auto imports, storage, utility, and service layers.
       </p>
     </section>
     <section class="grid">
@@ -18,7 +18,7 @@
       </article>
       <article>
         <h2>service</h2>
-        <p>API client setup and error normalization.</p>
+        <p>API client setup and error normalization without product-specific assumptions.</p>
       </article>
     </section>
   </main>

package/templates/scaffold/vue/src/service/http.ts

@@ -1,18 +1,82 @@
-import axios from "axios";
+import axios, { type AxiosResponse, type InternalAxiosRequestConfig } from "axios";
 
-export const http = axios.create({
-  baseURL: import.meta.env.VITE_API_BASE_URL || "/api",
-  timeout: 15_000
-});
+export interface HttpClientOptions {
+  baseURL?: string;
+  timeoutMs?: number;
+  getToken?: () => string | null | undefined;
+  onUnauthorized?: (error: Error) => void | Promise<void>;
+  isSuccess?: (payload: unknown, response: AxiosResponse) => boolean;
+  getMessage?: (payload: unknown, response?: AxiosResponse) => string | undefined;
+}
+
+export interface HttpError extends Error {
+  status?: number;
+  code?: string | number;
+  payload?: unknown;
+}
+
+export function createHttpClient(options: HttpClientOptions = {}) {
+  const client = axios.create({
+    baseURL: options.baseURL ?? import.meta.env.VITE_API_BASE_URL ?? "/api",
+    timeout: options.timeoutMs ?? 15_000,
+    headers: { "Content-Type": "application/json" },
+    paramsSerializer: {
+      indexes: null
+    }
+  });
 
-http.interceptors.response.use(
-  (response) => response,
-  (error) => Promise.reject(normalizeHttpError(error))
-);
+  client.interceptors.request.use((config: InternalAxiosRequestConfig) => {
+    const token = options.getToken?.();
+    if (token) {
+      config.headers.Authorization = `Bearer ${token}`;
+    }
+    return config;
+  });
+
+  client.interceptors.response.use(
+    async (response) => {
+      if (response.config.responseType === "blob") return response;
+      if (options.isSuccess && !options.isSuccess(response.data, response)) {
+        const error = createHttpError(options.getMessage?.(response.data, response) ?? "Request failed", response, response.data);
+        if (error.status === 401) await options.onUnauthorized?.(error);
+        throw error;
+      }
+      return response;
+    },
+    async (error) => {
+      const normalized = normalizeHttpError(error, options);
+      if (normalized.status === 401) await options.onUnauthorized?.(normalized);
+      return Promise.reject(normalized);
+    }
+  );
+
+  return client;
+}
 
-export function normalizeHttpError(error: unknown): Error {
+export const http = createHttpClient();
+
+export function normalizeHttpError(error: unknown, options: Pick<HttpClientOptions, "getMessage"> = {}): HttpError {
   if (axios.isAxiosError(error)) {
-    return new Error(error.response?.data?.message || error.message || "Request failed");
+    return createHttpError(
+      options.getMessage?.(error.response?.data, error.response) ?? error.response?.data?.message ?? error.message ?? "Request failed",
+      error.response,
+      error.response?.data
+    );
   }
   return error instanceof Error ? error : new Error(String(error));
 }
+
+function createHttpError(message: string, response?: AxiosResponse, payload?: unknown): HttpError {
+  const error = new Error(message) as HttpError;
+  error.status = response?.status;
+  error.payload = payload;
+  if (isRecord(payload)) {
+    const code = payload.code;
+    if (typeof code === "string" || typeof code === "number") error.code = code;
+  }
+  return error;
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}

package/templates/scaffold/vue/src/service/index.ts

@@ -1 +1 @@
-export { http, normalizeHttpError } from "./http";
+export { createHttpClient, http, normalizeHttpError, type HttpClientOptions, type HttpError } from "./http";

package/templates/scaffold/vue/src/storage/index.ts

@@ -1,15 +1,29 @@
+import { safeJsonParse } from "@/utils";
+
 type StorageKind = "local" | "session";
 
+interface StorageOptions {
+  namespace?: string;
+}
+
 function resolveStorage(kind: StorageKind): Storage {
   return kind === "session" ? sessionStorage : localStorage;
 }
 
-export function createStorage(kind: StorageKind = "local") {
+function createKey(key: string, namespace?: string): string {
+  return namespace ? `${namespace}:${key}` : key;
+}
+
+export function createStorage(kind: StorageKind = "local", options: StorageOptions = {}) {
   const storage = resolveStorage(kind);
+  const namespace = options.namespace;
 
   return {
+    key(key: string): string {
+      return createKey(key, namespace);
+    },
     get<T>(key: string): T | null {
-      const raw = storage.getItem(key);
+      const raw = storage.getItem(createKey(key, namespace));
       if (raw === null) return null;
       try {
         return JSON.parse(raw) as T;
@@ -18,14 +32,55 @@ export function createStorage(kind: StorageKind = "local") {
         throw new Error(`Storage value for ${key} is not valid JSON: ${message}`);
       }
     },
+    getOr<T>(key: string, fallback: T): T {
+      return safeJsonParse(storage.getItem(createKey(key, namespace)), fallback);
+    },
     set<T>(key: string, value: T): void {
-      storage.setItem(key, JSON.stringify(value));
+      storage.setItem(createKey(key, namespace), JSON.stringify(value));
     },
     remove(key: string): void {
-      storage.removeItem(key);
+      storage.removeItem(createKey(key, namespace));
     },
     clear(): void {
       storage.clear();
     }
   };
 }
+
+export function createCookieStorage(options: StorageOptions & { maxAgeSeconds?: number } = {}) {
+  const namespace = options.namespace;
+  const maxAgeSeconds = options.maxAgeSeconds;
+
+  return {
+    key(key: string): string {
+      return createKey(key, namespace);
+    },
+    get<T>(key: string): T | string | null {
+      const value = readCookie(createKey(key, namespace));
+      if (value === null) return null;
+      return safeJsonParse<T | string>(value, value);
+    },
+    set<T>(key: string, value: T): void {
+      const encodedKey = encodeURIComponent(createKey(key, namespace));
+      const encodedValue = encodeURIComponent(JSON.stringify(value));
+      const maxAge = typeof maxAgeSeconds === "number" ? `; max-age=${maxAgeSeconds}` : "";
+      document.cookie = `${encodedKey}=${encodedValue}${maxAge}; path=/`;
+    },
+    remove(key: string): void {
+      document.cookie = `${encodeURIComponent(createKey(key, namespace))}=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/`;
+    },
+    has(key: string): boolean {
+      return readCookie(createKey(key, namespace)) !== null;
+    }
+  };
+}
+
+function readCookie(key: string): string | null {
+  const encodedKey = encodeURIComponent(key);
+  const item = document.cookie
+    .split(";")
+    .map((part) => part.trim())
+    .find((part) => part.startsWith(`${encodedKey}=`));
+  if (!item) return null;
+  return decodeURIComponent(item.slice(encodedKey.length + 1));
+}

package/templates/scaffold/vue/src/styles/main.scss

@@ -1,4 +1,6 @@
 @use "./tokens" as *;
+@use "./reset";
+@use "./utilities";
 
 :root {
   color-scheme: light;
@@ -10,12 +12,3 @@
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
 }
-
-* { box-sizing: border-box; }
-
-html, body, #app {
-  min-height: 100%;
-  margin: 0;
-}
-
-body { background: $color-surface-muted; }

package/templates/scaffold/vue/src/styles/reset.scss

@@ -0,0 +1,23 @@
+@use "./tokens" as *;
+
+* {
+  box-sizing: border-box;
+}
+
+html,
+body,
+#app {
+  min-height: 100%;
+  margin: 0;
+}
+
+body {
+  background: $color-surface-muted;
+}
+
+button,
+input,
+textarea,
+select {
+  font: inherit;
+}

package/templates/scaffold/vue/src/styles/tokens.scss

@@ -17,4 +17,3 @@ $space-6: 24px;
 
 $radius-control: 6px;
 $radius-card: 8px;
-$table-min-width: 960px;

package/templates/scaffold/vue/src/styles/utilities.scss

@@ -0,0 +1,38 @@
+@use "./tokens" as *;
+
+.u-flex {
+  display: flex;
+}
+
+.u-flex-column {
+  display: flex;
+  flex-direction: column;
+}
+
+.u-flex-center {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.u-flex-between {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.u-text-truncate {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.u-full-width {
+  width: 100%;
+}
+
+.u-surface {
+  background: $color-surface;
+  border: 1px solid $color-border;
+  border-radius: $radius-card;
+}

package/templates/scaffold/vue/src/utils/index.ts

@@ -9,3 +9,72 @@ export function isBlank(value: unknown): value is string {
 export function pickDefined<T extends Record<string, unknown>>(value: T): Partial<T> {
   return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined)) as Partial<T>;
 }
+
+export function safeJsonParse<T>(value: string | null, fallback: T): T {
+  if (value === null || value.trim() === "") return fallback;
+  try {
+    return JSON.parse(value) as T;
+  } catch {
+    return fallback;
+  }
+}
+
+export async function awaitTo<T>(promise: Promise<T>): Promise<[Error, null] | [null, T]> {
+  try {
+    return [null, await promise];
+  } catch (error) {
+    return [normalizeError(error), null];
+  }
+}
+
+export function normalizeError(error: unknown): Error {
+  return error instanceof Error ? error : new Error(String(error));
+}
+
+export function debounce<T extends (...args: unknown[]) => void>(callback: T, delayMs: number): (...args: Parameters<T>) => void {
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  return (...args) => {
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => callback(...args), delayMs);
+  };
+}
+
+export function debounceAsync<T extends (...args: unknown[]) => Promise<unknown>>(
+  callback: T,
+  delayMs: number
+): (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>>> {
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  return (...args) =>
+    new Promise((resolve, reject) => {
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        callback(...args).then(
+          (value) => resolve(value as Awaited<ReturnType<T>>),
+          (error) => reject(error)
+        );
+      }, delayMs);
+    });
+}
+
+export function createLoadingTask<TArgs extends unknown[], TResult>(
+  task: (...args: TArgs) => Promise<TResult>
+): {
+  readonly isLoading: boolean;
+  run: (...args: TArgs) => Promise<TResult | null>;
+} {
+  let loading = false;
+  return {
+    get isLoading() {
+      return loading;
+    },
+    async run(...args) {
+      if (loading) return null;
+      loading = true;
+      try {
+        return await task(...args);
+      } finally {
+        loading = false;
+      }
+    }
+  };
+}

package/templates/scaffold/vue/tests/e2e/app-desktop.spec.ts

@@ -3,7 +3,7 @@ import { expect, test } from "@playwright/test";
 test("desktop smoke renders the scaffold shell", async ({ page }) => {
   await page.goto("/");
 
-  await expect(page.getByRole("heading", { level: 1, name: "Engineering base is ready" })).toBeVisible();
+  await expect(page.getByRole("heading", { level: 1, name: "Project foundation is ready" })).toBeVisible();
   await expect(page.getByRole("heading", { level: 2, name: "utils" })).toBeVisible();
   await expect(page.getByRole("heading", { level: 2, name: "storage" })).toBeVisible();
   await expect(page.getByRole("heading", { level: 2, name: "service" })).toBeVisible();

package/templates/scaffold/vue/tests/e2e/app-mobile.spec.ts

@@ -3,7 +3,7 @@ import { expect, test } from "@playwright/test";
 test("mobile smoke keeps scaffold content in the viewport", async ({ page }) => {
   await page.goto("/");
 
-  await expect(page.getByRole("heading", { level: 1, name: "Engineering base is ready" })).toBeVisible();
+  await expect(page.getByRole("heading", { level: 1, name: "Project foundation is ready" })).toBeVisible();
   const documentOverflow = await page.evaluate(() => document.documentElement.scrollWidth > document.documentElement.clientWidth);
   expect(documentOverflow).toBe(false);
 });

package/templates/scaffold/vue/tests/integration/app.test.ts

@@ -4,10 +4,10 @@ import App from "../../src/App.vue";
 import { renderPage } from "../render";
 
 describe("scaffold app", () => {
-  it("renders the engineering baseline sections", () => {
+  it("renders the application baseline sections", () => {
     renderPage(App);
 
-    expect(screen.getByRole("heading", { level: 1, name: "Engineering base is ready" })).toBeInTheDocument();
+    expect(screen.getByRole("heading", { level: 1, name: "Project foundation is ready" })).toBeInTheDocument();
     expect(screen.getByRole("heading", { level: 2, name: "utils" })).toBeInTheDocument();
     expect(screen.getByRole("heading", { level: 2, name: "storage" })).toBeInTheDocument();
     expect(screen.getByRole("heading", { level: 2, name: "service" })).toBeInTheDocument();