@synopackageland/templates 0.42.0 → 0.42.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.42.2
+
+- New Apps get no header Refresh. The Vue templates leave `AppShell`'s `#actions` empty (Sign out only with standalone login), so the shell draws no bar above the page; the plain UI's title row drops its Refresh button
+- Data stays fresh without it: reopening the window reads the status, panels and portal again, the Vue status page reads again each time it is shown, and a failed read offers Retry beside its error
+- Delegate templates keep their Retry inside the capability's own error Callout
+- READMEs, `DESIGN.md` and `AGENTS.md` say `#actions` is for real page actions (such as Add), never a Refresh
+- Drop the unused `refresh`, `greeting`, `save` and `saved` messages; error texts no longer ask the user to refresh
+
+## 0.42.1
+
+- The commented `backup` example in the native and binary `dsm-package.yaml` says online backup reads SQLite in place, and shows the optional `exclude` list of data-folder globs left out of the archive (SDK 0.53.35, CLI 0.53.13)
+
 ## 0.42.0
 
 - Scaffold pnpm projects with pinned package managers and reproducible lockfiles

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synopackageland/templates",
-  "version": "0.42.0",
+  "version": "0.42.2",
   "description": "Project templates for synopkgland init: native-go, native-python, native-node and native-rust (plain or Vue, with jobs, delegate and root-ops overlays), binary and compose.",
   "license": "MIT",
   "repository": {

package/templates/_shared/AGENTS.md

@@ -17,6 +17,12 @@ Only a confirmed refusal (signed out, expired session, not an administrator)
 shows the sign-in page or a `@synopackageland/ui` Dialog; loading text inside a
 section is fine.
 
+Do not add a header Refresh. Re-read data when the window is shown again
+(`ctx.reopen`) and when a page is shown; a failed read offers Retry beside its
+error. `AppShell`'s `#actions` is for real page actions (such as Add); with
+nothing in it the shell draws no bar. A section that needs a manual re-read
+gets its own action in that section.
+
 Everything below holds for every native backend language; the backend
 sections at the end name each language's files, types and test commands.
 

package/templates/binary/dsm-package.yaml

@@ -44,9 +44,12 @@ ui: {dir: ui, launch: new-page}
 # generated scripts/backup/ as root: a fixed script that only switches to the
 # package account. See `synopkgland skill show backup`.
 # backup:
-#   online: false          # true keeps the App running; SQLite is snapshotted
+#   online: false          # true keeps the App running; SQLite is read in
+#                          # place. Other files are read as they are: a file
+#                          # being written meanwhile may be inconsistent
 #   data_version: "1.0"    # "major.minor"; a restore refuses newer data
 #   hook: bin/backup-hook  # optional packaged freeze/thaw executable
+#   exclude: [tmp]         # optional data-folder globs left out (scratch data)
 # To opt out, use only:
 # backup:
 #   hyper_backup: false

package/templates/native-go/README.md

@@ -205,7 +205,10 @@ the new version; `synopkgland check` refuses mismatched versions.
 `ui/app.js` must register `window.DsmPackageApps[<package>].mount(root, ctx)`
 (the template shows how, using `document.currentScript.dataset.package`).
 `ctx.call(method, params)` is the only transport. `ctx.reopen(fn)` runs `fn`
-whenever DSM shows the window again and returns an idempotent unsubscribe function. Scope your CSS under your own root class:
+whenever DSM shows the window again and returns an idempotent unsubscribe function.
+The template re-reads its status there instead of showing a Refresh button; a
+failed read shows Retry beside its error. Keep header buttons for real page
+actions, such as Add. Scope your CSS under your own root class:
 every DSM app shares one page.
 
 Plain JS and Vue receive the same `ctx.host` adapter. `ctx.host.platform()`

package/templates/native-go/dsm-package.yaml

@@ -78,9 +78,12 @@ capabilities: {}
 # generated scripts/backup/ as root: a fixed script that only switches to the
 # package account. See `synopkgland skill show backup`.
 # backup:
-#   online: false          # true keeps the App running; SQLite is snapshotted
+#   online: false          # true keeps the App running; SQLite is read in
+#                          # place. Other files are read as they are: a file
+#                          # being written meanwhile may be inconsistent
 #   data_version: "1.0"    # "major.minor"; a restore refuses newer data
 #   hook: bin/backup-hook  # optional packaged freeze/thaw executable
+#   exclude: [tmp]         # optional data-folder globs left out (scratch data)
 # To opt out, use only:
 # backup:
 #   hyper_backup: false

package/templates/native-go/i18n/glossary.json

@@ -163,9 +163,7 @@
         "es": "Actualizar",
         "it": "Aggiorna"
       },
-      "keys": [
-        "app.refresh"
-      ]
+      "keys": []
     },
     {
       "id": "retry",
@@ -181,7 +179,9 @@
         "es": "Volver a intentar",
         "it": "Riprova"
       },
-      "keys": []
+      "keys": [
+        "app.retry"
+      ]
     },
     {
       "id": "back",

package/templates/native-go/i18n/messages/de.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "Aktualisieren",
+  "app.retry": "Neuer Versuch",
   "app.title": "Es funktioniert",
   "error.admin_required": "Dieses Benutzerkonto verfügt nicht über die erforderlichen Berechtigungen, um diese Aktion durchzuführen",
   "error.app_privilege_denied": "Dieses Benutzerkonto verfügt nicht über die erforderlichen Berechtigungen, um diese Aktion durchzuführen",

package/templates/native-go/i18n/messages/en.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "Refresh",
+  "app.retry": "Retry",
   "app.title": "It works",
   "error.admin_required": "Sorry, this user account has not been assigned proper privileges to perform this action",
   "error.app_privilege_denied": "Sorry, this user account has not been assigned proper privileges to perform this action",

package/templates/native-go/i18n/messages/es.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "Actualizar",
+  "app.retry": "Volver a intentar",
   "app.title": "Funciona",
   "error.admin_required": "A esta cuenta de usuario no se le han asignado los privilegios adecuados para realizar esta acción",
   "error.app_privilege_denied": "A esta cuenta de usuario no se le han asignado los privilegios adecuados para realizar esta acción",

package/templates/native-go/i18n/messages/fr.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "Actualiser",
+  "app.retry": "Réessayer",
   "app.title": "Ça fonctionne",
   "error.admin_required": "Désolé, ce compte utilisateur ne dispose pas des droits nécessaires pour accomplir cette action",
   "error.app_privilege_denied": "Désolé, ce compte utilisateur ne dispose pas des droits nécessaires pour accomplir cette action",

package/templates/native-go/i18n/messages/it.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "Aggiorna",
+  "app.retry": "Riprova",
   "app.title": "Funziona",
   "error.admin_required": "Siamo spiacenti, a questo account utente non sono stati assegnati privilegi appropriati per eseguire questa azione",
   "error.app_privilege_denied": "Siamo spiacenti, a questo account utente non sono stati assegnati privilegi appropriati per eseguire questa azione",

package/templates/native-go/i18n/messages/ja.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "最新の情報に更新",
+  "app.retry": "再試行",
   "app.title": "動作しています",
   "error.admin_required": "申し訳ありませんが、このユーザー アカウントにはこの操作を行うための権限が与えられていません",
   "error.app_privilege_denied": "申し訳ありませんが、このユーザー アカウントにはこの操作を行うための権限が与えられていません",

package/templates/native-go/i18n/messages/ko.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "새로 고침",
+  "app.retry": "재시도",
   "app.title": "정상적으로 작동합니다",
   "error.admin_required": "죄송합니다. 이 사용자 계정에는 이 작업을 수행하기에 적절한 권한이 할당되지 않았습니다",
   "error.app_privilege_denied": "죄송합니다. 이 사용자 계정에는 이 작업을 수행하기에 적절한 권한이 할당되지 않았습니다",

package/templates/native-go/i18n/messages/zh-CN.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "刷新",
+  "app.retry": "重试",
   "app.title": "运行成功",
   "error.admin_required": "抱歉，此用户帐户权限不足，无法执行此操作",
   "error.app_privilege_denied": "抱歉，此用户帐户权限不足，无法执行此操作",

package/templates/native-go/i18n/messages/zh-TW.json

@@ -1,5 +1,5 @@
 {
-  "app.refresh": "重新整理",
+  "app.retry": "重試",
   "app.title": "成功運作了",
   "error.admin_required": "抱歉，此使用者帳號權限不足，無法執行此動作",
   "error.app_privilege_denied": "抱歉，此使用者帳號權限不足，無法執行此動作",

package/templates/native-go/ui/app.css

@@ -34,7 +34,6 @@
   background: var(--ui-surface);
 }
 .dsmapp *, .dsmapp *::before, .dsmapp *::after { box-sizing: inherit; }
-.dsmapp-header { display: flex; align-items: center; justify-content: space-between; gap: var(--ui-space-3); }
 .dsmapp h1 { margin: 0 0 var(--ui-space-1); font-size: var(--ui-font-size-title); font-weight: 600; }
 .dsmapp-secondary {
   height: var(--ui-control-md); padding: 0 var(--ui-space-3); border: 1px solid var(--ui-border); border-radius: var(--ui-radius-sm);
@@ -55,6 +54,8 @@
 .dsmapp-form button:disabled { opacity: 0.6; cursor: default; }
 .dsmapp-note { margin: 0; color: var(--ui-text-secondary); font-size: var(--ui-font-size-sm); }
 .dsmapp-note[hidden] { display: none; }
+.dsmapp-message-row { display: flex; flex-wrap: wrap; align-items: center; gap: var(--ui-space-3); }
+.dsmapp-message-row .dsmapp-message { flex: 1 1 auto; }
 .dsmapp-message { min-height: var(--ui-line-height); color: var(--ui-danger-text); }
 .dsmapp-facts { display: grid; grid-template-columns: fit-content(40%) minmax(0, 1fr); gap: var(--ui-space-1) var(--ui-space-4); margin: 0; }
 .dsmapp-facts dt { color: var(--ui-text-secondary); }

package/templates/native-go/ui/app.js

@@ -36,14 +36,16 @@
   function mount(root, ctx) {
     var t = ctx.t;
     var status = el("dl", { class: "dsmapp-facts" });
-    var refreshButton = el("button", { type: "button", class: "dsmapp-secondary", text: t("app.refresh") });
     var message = el("p", { class: "dsmapp-message", role: "status" });
+    // Shown only after a failed read; the App re-reads on reopen, so no header Refresh.
+    var retryButton = el("button", { type: "button", class: "dsmapp-secondary", text: t("app.retry") });
+    retryButton.hidden = true;
     var portal = ctx.portal ? el("section", { class: "dsmapp-portal" }) : null;
 
     root.classList.add("dsmapp");
     root.replaceChildren(
-      el("div", { class: "dsmapp-header" }, [el("h1", { text: t("app.title") }), refreshButton]),
-      message,
+      el("h1", { text: t("app.title") }),
+      el("div", { class: "dsmapp-message-row" }, [message, retryButton]),
       el("h2", { text: t("status.heading") }),
       status
     );
@@ -54,10 +56,12 @@
       var code = (error && error.code) || "internal";
       var text = t("error." + code);
       message.textContent = text === "error." + code ? (error && error.message) || t("error.internal") : text;
+      retryButton.hidden = false;
     }
 
     function refresh() {
       message.textContent = "";
+      retryButton.hidden = true;
       ctx.call("app.status").then(function (data) {
         status.replaceChildren();
         [[t("status.user"), data.admin ? t("status.userAdmin", { user: data.user }) : data.user],
@@ -73,7 +77,7 @@
       }).catch(showError);
     }
 
-    refreshButton.addEventListener("click", refresh);
+    retryButton.addEventListener("click", refresh);
 
     ctx.reopen(refresh);
     refresh();

package/templates/native-go-delegate/frontend/test/capability-panels.test.ts

@@ -102,7 +102,8 @@ test('the app mount forwards ctx.executor to administrator setup only',async()=>
   }
  }
 })
-test('the header Refresh reloads the save destinations',async()=>{
+// No header Refresh: reopening the App reloads the save destinations.
+test('reopening the App reloads the save destinations',async()=>{
  const call=vi.fn(async(method:string)=>{
   if(method==='app.status')return {package:'DelegateApp',version:'1',user:'alice',admin:false}
   if(method==='delegate.status')return {state:'ready',disabled:false,lifetime:'until-revoked',destinations:['save']}
@@ -112,11 +113,13 @@ test('the header Refresh reloads the save destinations',async()=>{
    throw {code:'unknown_method'}
  })
  const root=document.createElement('div');document.body.append(root)
- const app=mount(root,dsmWindow({call}))
+ const reopen:Array<()=>void>=[]
+ const app=mount(root,dsmWindow({call,reopen(fn:()=>void){reopen.push(fn);return ()=>{}}}))
  cleanup.push(()=>{app.unmount();root.remove()});await settle()
  const reads=()=>call.mock.calls.filter(([method])=>method==='delegate.destination').length
  const before=reads();expect(before).toBeGreaterThan(0)
- button(root,'Refresh').click();await settle()
+ expect([...root.querySelectorAll('button')].some(n=>n.textContent?.trim()==='Refresh')).toBe(false)
+ reopen.forEach(fn=>fn());await settle()
  expect(reads()).toBeGreaterThan(before)
 })
 test('the panels show a skeleton while the delegate status loads',async()=>{

package/templates/native-go-jobs/frontend/test/background-shell.test.ts

@@ -17,3 +17,21 @@ test('a jobs project opens its shell without starting a job',async()=>{
   expect(call.mock.calls.some(([method])=>method.startsWith('bg.'))).toBe(false)
  }finally{app.unmount();root.remove()}
 })
+// No header Refresh: showing the status page again reads its status again.
+test('returning to the status page reads its status again',async()=>{
+ const call=vi.fn(async(method:string)=>{
+  if(method==='app.status')return {package:'Jobs',version:'1',user:'alice',admin:false}
+  throw {code:'unknown_method'}
+ })
+ const root=document.createElement('div');document.body.append(root)
+ const app=mount(root,dsmWindow({call}))
+ try{
+  await settle()
+  const reads=()=>call.mock.calls.filter(([method])=>method==='app.status').length
+  const item=(name:string)=>[...root.querySelectorAll<HTMLElement>('button')].find(n=>n.textContent?.trim()===name)!
+  item('Background jobs').click();await settle()
+  const before=reads()
+  item('Status').click();await settle()
+  expect(reads()).toBeGreaterThan(before)
+ }finally{app.unmount();root.remove()}
+})

package/templates/native-go-vue/README.md

@@ -42,8 +42,7 @@ pnpm test
 pnpm run build
 ```
 
-The base app reads package status and edits the package greeting through
-`ctx.call`. Each window has its own Vue mount, request state and host
+The base app reads package status through `ctx.call`. Each window has its own Vue mount, request state and host
 subscriptions; unmount disposes subscriptions and ignores late responses.
 
 The build emits `app.module.js`, `app.css` and any lazy chunks. The entry
@@ -94,7 +93,7 @@ SDK's light default in place.
 
 Use the installed `@synopackageland/ui` and its declared compatible patch range.
 `App.vue` lays the shell out with the SDK's `AppShell` (`@synopackageland/sdk/vue`):
-`pages` from `shellPages`, the page's buttons in `#actions` and the pages in its
+`pages` from `shellPages`, real page actions in `#actions` and the pages in its
 default slot. On desktop, the sidebar names the page: the shell shows no page title, puts
 `#actions` in a bar above the page and scrolls only the content; a settings
 page (`SectionTabs fill` or `SettingsPage`) keeps its tabs and footer in place
@@ -109,6 +108,14 @@ device-width viewport. Its full-page sidebar names the App with
 shows the signed-in DSM account and its role from `ctx.user`. See the ui's
 `docs/adaptive-layout.md`.
 
+The template puts no Refresh in `#actions`, and with nothing there `AppShell`
+draws no bar above the page. Data stays fresh without one: `ctx.reopen` reads
+the status, the panels and the portal again when the window is shown again,
+and showing the status page again reads it again. A failed read offers Retry
+beside its error. Sign out appears in `#actions` only when standalone login is
+on. Keep `#actions` for real page actions, such as Add; a section that needs a
+manual re-read gets its own action in that section, not a header Refresh.
+
 The frontend SDK and UI use patch ranges; the lockfile records the installed
 versions. Update the lockfile deliberately when taking a newer patch.
 
@@ -120,8 +127,8 @@ keeps that branding, and the UI hides a bar with nothing in it. When using
 even with `phone-bar-title="none"`. Pages outside the tab bar and detail pages
 with Back keep their title bar. `header-actions` share one "…" menu; only an
 entry marked `primary: true`, or a sole entry with an icon, becomes a separate
-bar button. The template's `#actions` stays page actions; no title or empty-bar
-workaround is needed.
+bar button. The template's `#actions` holds only real page actions; no title or
+empty-bar workaround is needed.
 
 `AppShell`'s `app-root` wraps it in an app-local `AppRoot` (app modal scope, on
 a full page as well, bounded at `height: 100%`) with the UI locale from

package/templates/native-go-vue/frontend/DESIGN.md

@@ -30,8 +30,8 @@ Use `syno-pkg-land-ui` directly in package scripts; keep AI guidance version-ind
 ## Overview
 
 The template runs inside a DSM package window. `AppShell` provides status and
-optional background navigation. The base page shows package status and a greeting
-editor; the root overlay adds its existing fixed-operation authorization gate.
+optional background navigation. The base page shows package status; the root
+overlay adds its existing fixed-operation authorization gate.
 
 Use the installed `@synopackageland/ui` controls and `themes/dsm7-embedded.css`.
 The theme owns colors, typography, spacing and dialogs. Keep per-app modal scope,
@@ -39,7 +39,11 @@ a unique Vue ID prefix and vertical scrolling at the DSM minimum window size.
 In a DSM window, Dialogs may leave the window (`dialog-bounds="viewport"`) and a
 press on one brings the window to the front; below 600px they are bottom sheets.
 
-Refresh and save expose busy state and localized errors. Reopen refreshes status.
+There is no header Refresh: reopening the window, or showing the status page
+again, reads it again, and a failed read offers Retry beside its error. The
+shell's `#actions` holds only real page actions (Sign out with standalone
+login); empty, the shell draws no bar. Reads expose busy state and localized
+errors.
 Each mount owns its state; unmount unsubscribes from host events and ignores late
 responses. Backend route policies decide access.
 

package/templates/native-go-vue/frontend/src/App.vue

@@ -46,13 +46,15 @@ async function refresh() {
  } catch(e) {if(!disposed && !(early && login.enabled.value)) error.value = message(e)}
  finally {if(!disposed) {busy.value=false; if(again) {again=false; void refresh()}}}
 }
-// The header Refresh also reloads the panels below and reads the portal again.
+// No header Refresh: reopening the App, or showing its status page again, reads
+// the status, the panels below and the portal again.
 const panels = ref<{refresh(): unknown}>()
 const portalReads = ref(0)
 const portalKey = computed(() => `${app.value?.user}:${portalReads.value}`)
 function refreshAll() {
  void refresh(); void panels.value?.refresh(); portalReads.value++
 }
+watch(page, shown => {if(shown==='status') refreshAll()})
 watch(login.subject, (subject, previous) => {
  if(!subject) {app.value=undefined;error.value=''}
  else if((!previous || previous.user!==subject.user)) void refresh()
@@ -61,7 +63,7 @@ async function signOut() {
  try {await login.logout()} catch(e) {if(!disposed) error.value=message(e)}
 }
 onMounted(()=>{
- unsubscribe = props.ctx.reopen(()=>{if(!disposed) void refresh()})
+ unsubscribe = props.ctx.reopen(()=>{if(!disposed) refreshAll()})
  // The session check runs in the background; only a confirmed sign-in need replaces the App.
  void login.start()
  void refresh()
@@ -72,10 +74,11 @@ onUnmounted(()=>{disposed=true;unsubscribe?.();login.dispose()})
 <template>
  <AppShell app-root v-model="page" :ctx="shellCtx" :locale="ctx.locale" :pages="pages" :denied="signIn" sidebar-storage-key="__PACKAGE__">
   <template #denied><LoginPage :session="login" :locale="ctx.locale" /></template>
-  <template #actions><Button variant="secondary" :disabled="busy" @click="refreshAll">{{ copy.refresh }}</Button><Button v-if="login.enabled.value" variant="secondary" :disabled="busy" @click="signOut">{{ copy.signOut }}</Button></template>
+  <!-- #actions holds real page actions (such as Add), never a Refresh. Without one the shell draws no bar. -->
+  <template v-if="login.enabled.value" #actions><Button variant="secondary" :disabled="busy" @click="signOut">{{ copy.signOut }}</Button></template>
   <ExecutorGate :ctx="ctx" :admin="ctx.user?.isAdmin ?? !!app?.admin">
   <div class="integration-app" :aria-busy="busy" :aria-label="copy.settings">
-   <Callout v-if="error" tone="danger" :title="copy.actionRequired"><span role="alert">{{ error }}</span></Callout>
+   <Callout v-if="error" tone="danger" :title="copy.actionRequired"><span role="alert">{{ error }}</span><template #actions><Button variant="secondary" :disabled="busy" @click="refreshAll">{{ copy.retry }}</Button></template></Callout>
    <div data-page="status" v-show="page==='status'">
     <SettingsSection :title="copy.statusTitle" :collapsible="false" :loading="busy && !app">
      <div v-if="app" data-app-status>

package/templates/native-go-vue/frontend/src/i18n/de.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "Aktualisieren",
+  "retry": "Neuer Versuch",
   "signOut": "Abmelden",
   "settings": "Paketeinstellungen",
   "actionRequired": "Aktion erforderlich",
   "statusTitle": "Paketstatus",
-  "statusError": "Status nicht verfügbar. Aktualisieren Sie die Ansicht",
-  "greeting": "Begrüßung",
-  "save": "Speichern",
-  "saved": "Begrüßung gespeichert",
+  "statusError": "Status nicht verfügbar",
   "errors": {
     "session_required": "Ihre DSM-Sitzung ist abgelaufen. Melden Sie sich erneut an",
     "admin_required": "Diese Aktion muss ein DSM-Administrator ausführen",
     "app_privilege_denied": "Die DSM-Anwendungsberechtigungen erlauben diesem Konto nicht, diese App zu verwenden",
-    "auth_unavailable": "Die DSM-Authentifizierung ist nicht verfügbar. Aktualisieren Sie die Ansicht und versuchen Sie es erneut",
-    "request_failed": "Anfrage fehlgeschlagen ({code}). Aktualisieren Sie die Ansicht und versuchen Sie es erneut"
+    "auth_unavailable": "Die DSM-Authentifizierung ist nicht verfügbar. Versuchen Sie es später erneut",
+    "request_failed": "Anfrage fehlgeschlagen ({code}). Versuchen Sie es erneut"
   },
   "packageName": "Paketname",
   "user": "Benutzer",

package/templates/native-go-vue/frontend/src/i18n/en.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "Refresh",
+  "retry": "Retry",
   "signOut": "Sign out",
   "settings": "Package settings",
   "actionRequired": "Action required",
   "statusTitle": "Package status",
-  "statusError": "Unable to load status. Refresh to try again",
-  "greeting": "Greeting",
-  "save": "Save",
-  "saved": "Greeting saved",
+  "statusError": "Unable to load status",
   "errors": {
     "session_required": "Your DSM session expired. Sign in again",
     "admin_required": "A DSM administrator must perform this action",
     "app_privilege_denied": "DSM Application Privileges do not allow this account to use this app",
-    "auth_unavailable": "DSM authentication is unavailable. Refresh to try again",
-    "request_failed": "Request failed ({code}). Refresh and try again"
+    "auth_unavailable": "DSM authentication is unavailable. Try again later",
+    "request_failed": "Request failed ({code}). Try again"
   },
   "packageName": "Package name",
   "user": "User",

package/templates/native-go-vue/frontend/src/i18n/es.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "Actualizar",
+  "retry": "Volver a intentar",
   "signOut": "Cerrar sesión",
   "settings": "Configuración del paquete",
   "actionRequired": "Acción necesaria",
   "statusTitle": "Estado del paquete",
-  "statusError": "Estado no disponible. Actualice la página",
-  "greeting": "Saludo",
-  "save": "Guardar",
-  "saved": "Saludo guardado",
+  "statusError": "Estado no disponible",
   "errors": {
     "session_required": "Su sesión de DSM ha caducado. Vuelva a iniciar sesión",
     "admin_required": "Un administrador de DSM debe realizar esta acción",
     "app_privilege_denied": "Los privilegios de aplicación de DSM no permiten que esta cuenta use esta aplicación",
-    "auth_unavailable": "La autenticación de DSM no está disponible. Actualice e inténtelo de nuevo",
-    "request_failed": "La solicitud falló ({code}). Actualice e inténtelo de nuevo"
+    "auth_unavailable": "La autenticación de DSM no está disponible. Inténtelo de nuevo más tarde",
+    "request_failed": "La solicitud falló ({code}). Inténtelo de nuevo"
   },
   "packageName": "Nombre del paquete",
   "user": "Usuario",

package/templates/native-go-vue/frontend/src/i18n/fr.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "Actualiser",
+  "retry": "Réessayer",
   "signOut": "Se déconnecter",
   "settings": "Paramètres du paquet",
   "actionRequired": "Action requise",
   "statusTitle": "État du paquet",
-  "statusError": "État indisponible. Actualisez la page",
-  "greeting": "Message d’accueil",
-  "save": "Sauvegarder",
-  "saved": "Message d’accueil enregistré",
+  "statusError": "État indisponible",
   "errors": {
     "session_required": "Votre session DSM a expiré. Reconnectez-vous",
     "admin_required": "Un administrateur DSM doit effectuer cette action",
     "app_privilege_denied": "Les privilèges d’application DSM n’autorisent pas ce compte à utiliser cette application",
-    "auth_unavailable": "L’authentification DSM n’est pas disponible. Actualisez et réessayez",
-    "request_failed": "La requête a échoué ({code}). Actualisez et réessayez"
+    "auth_unavailable": "L’authentification DSM n’est pas disponible. Réessayez plus tard",
+    "request_failed": "La requête a échoué ({code}). Réessayez"
   },
   "packageName": "Nom du paquet",
   "user": "Utilisateur",

package/templates/native-go-vue/frontend/src/i18n/it.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "Aggiorna",
+  "retry": "Riprova",
   "signOut": "Disconnetti",
   "settings": "Impostazioni del pacchetto",
   "actionRequired": "Azione richiesta",
   "statusTitle": "Stato del pacchetto",
-  "statusError": "Stato non disponibile. Aggiornare la pagina",
-  "greeting": "Saluto",
-  "save": "Salva",
-  "saved": "Saluto salvato",
+  "statusError": "Stato non disponibile",
   "errors": {
     "session_required": "La sessione DSM è scaduta. Accedere di nuovo",
     "admin_required": "Questa azione deve essere eseguita da un amministratore DSM",
     "app_privilege_denied": "I privilegi delle applicazioni DSM non consentono a questo account di usare questa app",
-    "auth_unavailable": "L’autenticazione DSM non è disponibile. Aggiornare e riprovare",
-    "request_failed": "Richiesta non riuscita ({code}). Aggiornare e riprovare"
+    "auth_unavailable": "L’autenticazione DSM non è disponibile. Riprovare più tardi",
+    "request_failed": "Richiesta non riuscita ({code}). Riprovare"
   },
   "packageName": "Nome pacchetto",
   "user": "Utente",

package/templates/native-go-vue/frontend/src/i18n/ja.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "最新の情報に更新",
+  "retry": "再試行",
   "signOut": "サインアウト",
   "settings": "パッケージ設定",
   "actionRequired": "対応が必要です",
   "statusTitle": "パッケージの状態",
-  "statusError": "ステータスを読み込めません。更新してください",
-  "greeting": "あいさつ",
-  "save": "保存",
-  "saved": "あいさつを保存しました",
+  "statusError": "ステータスを読み込めません",
   "errors": {
     "session_required": "DSM セッションの有効期限が切れました。もう一度サインインしてください",
     "admin_required": "この操作は DSM 管理者が行う必要があります",
     "app_privilege_denied": "DSM のアプリケーション権限により、このアカウントはこのアプリを使用できません",
-    "auth_unavailable": "DSM 認証を利用できません。最新の情報に更新してから、もう一度お試しください",
-    "request_failed": "リクエストに失敗しました（{code}）。最新の情報に更新してから、もう一度お試しください"
+    "auth_unavailable": "DSM 認証を利用できません。しばらくしてから、もう一度お試しください",
+    "request_failed": "リクエストに失敗しました（{code}）。もう一度お試しください"
   },
   "packageName": "パッケージ名",
   "user": "ユーザー",

package/templates/native-go-vue/frontend/src/i18n/ko.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "새로 고침",
+  "retry": "재시도",
   "signOut": "로그아웃",
   "settings": "패키지 설정",
   "actionRequired": "조치 필요",
   "statusTitle": "패키지 상태",
-  "statusError": "상태를 불러올 수 없습니다. 새로 고침하십시오",
-  "greeting": "인사말",
-  "save": "저장",
-  "saved": "인사말이 저장되었습니다",
+  "statusError": "상태를 불러올 수 없습니다",
   "errors": {
     "session_required": "DSM 세션이 만료되었습니다. 다시 로그인하십시오",
     "admin_required": "이 작업은 DSM 관리자가 수행해야 합니다",
     "app_privilege_denied": "DSM 응용 프로그램 권한에서 이 계정의 앱 사용이 허용되지 않습니다",
-    "auth_unavailable": "DSM 인증을 사용할 수 없습니다. 새로 고친 후 다시 시도하십시오",
-    "request_failed": "요청이 실패했습니다({code}). 새로 고친 후 다시 시도하십시오"
+    "auth_unavailable": "DSM 인증을 사용할 수 없습니다. 잠시 후 다시 시도하십시오",
+    "request_failed": "요청이 실패했습니다({code}). 다시 시도하십시오"
   },
   "packageName": "패키지 이름",
   "user": "사용자",

package/templates/native-go-vue/frontend/src/i18n/zh-CN.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "刷新",
+  "retry": "重试",
   "signOut": "注销",
   "settings": "套件设置",
   "actionRequired": "需要处理",
   "statusTitle": "套件状态",
-  "statusError": "无法加载状态，请刷新",
-  "greeting": "问候语",
-  "save": "保存",
-  "saved": "问候语已保存",
+  "statusError": "无法加载状态",
   "errors": {
     "session_required": "DSM 登录已过期，请重新登录",
     "admin_required": "此操作必须由 DSM 管理员执行",
     "app_privilege_denied": "DSM 应用程序权限不允许此账户使用此 App",
-    "auth_unavailable": "DSM 验证暂时不可用，请刷新后重试",
-    "request_failed": "请求失败（{code}），请刷新后重试"
+    "auth_unavailable": "DSM 验证暂时不可用，请稍后重试",
+    "request_failed": "请求失败（{code}），请重试"
   },
   "packageName": "套件名称",
   "user": "用户帐号",

package/templates/native-go-vue/frontend/src/i18n/zh-TW.json

@@ -1,19 +1,16 @@
 {
-  "refresh": "重新整理",
+  "retry": "重試",
   "signOut": "登出",
   "settings": "套件設定",
   "actionRequired": "需要處理",
   "statusTitle": "套件狀態",
-  "statusError": "無法載入狀態，請重新整理",
-  "greeting": "問候語",
-  "save": "儲存",
-  "saved": "問候語已儲存",
+  "statusError": "無法載入狀態",
   "errors": {
     "session_required": "DSM 登入已逾時，請重新登入",
     "admin_required": "此操作須由 DSM 管理員執行",
     "app_privilege_denied": "DSM 應用程式權限不允許此帳號使用這個 App",
-    "auth_unavailable": "DSM 驗證目前無法使用，請重新整理後再試",
-    "request_failed": "要求失敗（{code}），請重新整理後再試"
+    "auth_unavailable": "DSM 驗證目前無法使用，請稍後再試",
+    "request_failed": "要求失敗（{code}），請再試一次"
   },
   "packageName": "套件名稱",
   "user": "使用者帳號",

package/templates/native-go-vue/frontend/test/apps.test.ts

@@ -47,13 +47,26 @@ test('a DSM window stays light when the system prefers dark',async()=>{
   expect(f.root.textContent).toContain('Light')
  }finally{f.close();Object.defineProperty(window,'matchMedia',{configurable:true,writable:true,value:query})}
 })
-test('failed status loading offers a retry and releases the mounting class',async()=>{
+test('failed status loading offers a Retry beside the error and releases the mounting class',async()=>{
  const f=fixture('Failure')
  try{
-  await settle();f.call.mockRejectedValue({code:'auth_unavailable'});f.reopen.forEach(fn=>fn());await settle()
+  await settle();f.app.unmount()
+  let fail=true
+  f.call.mockImplementation(async(method:string)=>{
+   if(method!=='app.status')throw {code:'unknown_method'}
+   if(fail){fail=false;throw {code:'auth_unavailable'}}
+   return {package:'Failure',version:'1',user:'admin',admin:true}
+  })
+  const app=mount(f.root,f.ctx);await settle()
   expect(f.root.textContent).toContain('DSM authentication is unavailable')
-  expect(f.root.querySelector('button')?.disabled).toBe(false)
-  f.app.unmount();expect(f.root.classList.contains('dsmapp-vue-root')).toBe(false)
+  const retry=[...f.root.querySelectorAll<HTMLButtonElement>('[data-ui-callout-actions] button')].find(n=>n.textContent==='Retry')!
+  expect(retry.disabled).toBe(false)
+  const reads=f.call.mock.calls.filter(([method])=>method==='app.status').length
+  retry.click();await settle()
+  expect(f.call.mock.calls.filter(([method])=>method==='app.status').length).toBeGreaterThan(reads)
+  expect(f.root.textContent).not.toContain('DSM authentication is unavailable')
+  expect(f.root.querySelector('[data-app-status]')).not.toBeNull()
+  app.unmount();expect(f.root.classList.contains('dsmapp-vue-root')).toBe(false)
  }finally{f.close()}
 })
 test('a portal app shows the Application Portal section on the status page',async()=>{
@@ -70,7 +83,7 @@ test('a portal app shows the Application Portal section on the status page',asyn
   app.unmount()
  }finally{without.close();f.root.remove()}
 })
-test('the header Refresh reads the portal and executor status again',async()=>{
+test('reopening the App reads the status, portal and executor status again',async()=>{
  const f=fixture('Portal')
  try{
   await settle();f.app.unmount()
@@ -79,13 +92,42 @@ test('the header Refresh reads the portal and executor status again',async()=>{
   f.ctx.portal={messages:{title:'Application Portal',link:'Direct link:'},status:portal,apply:vi.fn(),disable:vi.fn(),openControlPanel:vi.fn(),mountPanel:vi.fn()}
   f.ctx.executor={status:executor,authorize:vi.fn(),control:vi.fn()} as unknown as Context['executor']
   const app=mount(f.root,f.ctx);await settle()
-  const [portalReads,executorReads]=[portal.mock.calls.length,executor.mock.calls.length]
-  ;[...f.root.querySelectorAll('button')].find(n=>n.textContent==='Refresh')!.click();await settle()
+  const reads=()=>f.call.mock.calls.filter(([method])=>method==='app.status').length
+  const [statusReads,portalReads,executorReads]=[reads(),portal.mock.calls.length,executor.mock.calls.length]
+  f.reopen.forEach(fn=>fn());await settle()
+  expect(reads()).toBeGreaterThan(statusReads)
   expect(portal.mock.calls.length).toBeGreaterThan(portalReads)
   expect(executor.mock.calls.length).toBeGreaterThan(executorReads)
   app.unmount()
  }finally{f.root.remove()}
 })
+// The template puts no Refresh in the shell's #actions: with nothing there the
+// shell draws no bar above the page. Sign out shows only with standalone login.
+test('the status page has no header bar and no Refresh button',async()=>{
+ const f=fixture('Bare')
+ try{
+  await settle()
+  expect([...f.root.querySelectorAll('button')].some(n=>n.textContent?.trim()==='Refresh')).toBe(false)
+  const bar=f.root.querySelector<HTMLElement>('[data-app-page-bar]')
+  expect(bar===null||bar.hidden).toBe(true)
+ }finally{f.close()}
+})
+test('with standalone login the bar holds only Sign out',async()=>{
+ const call=vi.fn(async(method:string)=>{
+  if(method==='identity.status')return {enabled:true}
+  if(method==='identity.session')return {user:'alice',uid:'1',expiresAt:new Date(Date.now()+3600_000).toISOString()}
+  if(method==='app.status')return {package:'Login',version:'1',user:'alice',admin:false}
+  throw {code:'unknown_method'}
+ })
+ const root=document.createElement('div');document.body.append(root)
+ const app=mount(root,dsmWindow({call}))
+ try{
+  await settle()
+  const bar=root.querySelector<HTMLElement>('[data-app-page-bar]')!
+  expect(bar.hidden).toBe(false)
+  expect([...bar.querySelectorAll('button')].map(n=>n.textContent?.trim())).toEqual(['Sign out'])
+ }finally{app.unmount();root.remove()}
+})
 test('the app renders and loads status while the session check is still pending',async()=>{
  const call=vi.fn(async(method:string)=>{
   if(method==='identity.status')return new Promise(()=>{})

package/templates/native-go-vue/frontend/test/shell-i18n.test.ts

@@ -8,8 +8,10 @@ import {appCopy} from '../src/i18n'
 import {identityCopy} from '@synopackageland/sdk/vue'
 async function settle(){for(let i=0;i<20;i++){await Promise.resolve();await nextTick()}}
 const buttons=(root:HTMLElement)=>[...root.querySelectorAll('button')].map(b=>b.textContent?.trim())
+const reopen:Array<()=>void>=[]
 function start(locale:string,call:(method:string)=>Promise<unknown>){
- const ctx=dsmWindow({locale,call:vi.fn(call) as never})
+ reopen.length=0
+ const ctx=dsmWindow({locale,call:vi.fn(call) as never,reopen(fn:()=>void){reopen.push(fn);return ()=>{}}})
  const root=document.createElement('div');document.body.append(root)
  const app=mount(root,ctx)
  return {root,close(){app.unmount();root.remove()}}
@@ -23,12 +25,12 @@ test('the status page and its errors follow the DSM language',async()=>{
  })
  try{
   await settle()
-  expect(buttons(root)).toContain(copy.refresh)
+  expect(buttons(root)).not.toContain('Aktualisieren')
   expect(root.textContent).toContain(copy.statusTitle)
   expect(root.textContent).toContain(copy.packageName)
-  expect(root.textContent).not.toContain(copy.greeting)
-  denied=true;[...root.querySelectorAll('button')].find(button=>button.textContent?.trim()===copy.refresh)!.click();await settle()
+  denied=true;reopen.forEach(fn=>fn());await settle()
   expect(root.textContent).toContain(copy.errors.admin_required)
+  expect(buttons(root)).toContain(copy.retry)
   expect(root.querySelector('[aria-label]')?.getAttribute('aria-label')).not.toBe('Package settings')
  }finally{close()}
 })

package/templates/native-node/dsm-package.yaml

@@ -87,9 +87,12 @@ capabilities: {}
 # generated scripts/backup/ as root: a fixed script that only switches to the
 # package account. See `synopkgland skill show backup`.
 # backup:
-#   online: false          # true keeps the App running; SQLite is snapshotted
+#   online: false          # true keeps the App running; SQLite is read in
+#                          # place. Other files are read as they are: a file
+#                          # being written meanwhile may be inconsistent
 #   data_version: "1.0"    # "major.minor"; a restore refuses newer data
 #   hook: bin/backup-hook  # optional packaged freeze/thaw executable
+#   exclude: [tmp]         # optional data-folder globs left out (scratch data)
 # To opt out, use only:
 # backup:
 #   hyper_backup: false

package/templates/native-node-vue/README.md

@@ -45,7 +45,7 @@ bridge App's runtime serves.
 
 Use the installed `@synopackageland/ui` and its declared compatible patch range.
 `App.vue` lays the shell out with the SDK's `AppShell` (`@synopackageland/sdk/vue`):
-`pages` from `shellPages`, the page's buttons in `#actions` and the pages in its
+`pages` from `shellPages`, real page actions in `#actions` and the pages in its
 default slot. On desktop, the sidebar names the page: the shell shows no page title, puts
 `#actions` in a bar above the page and scrolls only the content; a settings
 page (`SectionTabs fill` or `SettingsPage`) keeps its tabs and footer in place
@@ -60,6 +60,14 @@ device-width viewport. Its full-page sidebar names the App with
 shows the signed-in DSM account and its role from `ctx.user`. See the ui's
 `docs/adaptive-layout.md`.
 
+The template puts no Refresh in `#actions`, and with nothing there `AppShell`
+draws no bar above the page. Data stays fresh without one: `ctx.reopen` reads
+the status, the panels and the portal again when the window is shown again,
+and showing the status page again reads it again. A failed read offers Retry
+beside its error. Sign out appears in `#actions` only when standalone login is
+on. Keep `#actions` for real page actions, such as Add; a section that needs a
+manual re-read gets its own action in that section, not a header Refresh.
+
 The frontend SDK and UI use patch ranges; the lockfile records the installed
 versions. Update the lockfile deliberately when taking a newer patch.
 
@@ -71,8 +79,8 @@ keeps that branding, and the UI hides a bar with nothing in it. When using
 even with `phone-bar-title="none"`. Pages outside the tab bar and detail pages
 with Back keep their title bar. `header-actions` share one "…" menu; only an
 entry marked `primary: true`, or a sole entry with an icon, becomes a separate
-bar button. The template's `#actions` stays page actions; no title or empty-bar
-workaround is needed.
+bar button. The template's `#actions` holds only real page actions; no title or
+empty-bar workaround is needed.
 
 `AppShell`'s `app-root` wraps it in an app-local `AppRoot` (app modal scope, on
 a full page as well, bounded at `height: 100%`) with the UI locale from

package/templates/native-python/dsm-package.yaml

@@ -84,9 +84,12 @@ capabilities: {}
 # generated scripts/backup/ as root: a fixed script that only switches to the
 # package account. See `synopkgland skill show backup`.
 # backup:
-#   online: false          # true keeps the App running; SQLite is snapshotted
+#   online: false          # true keeps the App running; SQLite is read in
+#                          # place. Other files are read as they are: a file
+#                          # being written meanwhile may be inconsistent
 #   data_version: "1.0"    # "major.minor"; a restore refuses newer data
 #   hook: bin/backup-hook  # optional packaged freeze/thaw executable
+#   exclude: [tmp]         # optional data-folder globs left out (scratch data)
 # To opt out, use only:
 # backup:
 #   hyper_backup: false

package/templates/native-python-vue/README.md

@@ -45,7 +45,7 @@ bridge App's runtime serves.
 
 Use the installed `@synopackageland/ui` and its declared compatible patch range.
 `App.vue` lays the shell out with the SDK's `AppShell` (`@synopackageland/sdk/vue`):
-`pages` from `shellPages`, the page's buttons in `#actions` and the pages in its
+`pages` from `shellPages`, real page actions in `#actions` and the pages in its
 default slot. On desktop, the sidebar names the page: the shell shows no page title, puts
 `#actions` in a bar above the page and scrolls only the content; a settings
 page (`SectionTabs fill` or `SettingsPage`) keeps its tabs and footer in place
@@ -60,6 +60,14 @@ device-width viewport. Its full-page sidebar names the App with
 shows the signed-in DSM account and its role from `ctx.user`. See the ui's
 `docs/adaptive-layout.md`.
 
+The template puts no Refresh in `#actions`, and with nothing there `AppShell`
+draws no bar above the page. Data stays fresh without one: `ctx.reopen` reads
+the status, the panels and the portal again when the window is shown again,
+and showing the status page again reads it again. A failed read offers Retry
+beside its error. Sign out appears in `#actions` only when standalone login is
+on. Keep `#actions` for real page actions, such as Add; a section that needs a
+manual re-read gets its own action in that section, not a header Refresh.
+
 The frontend SDK and UI use patch ranges; the lockfile records the installed
 versions. Update the lockfile deliberately when taking a newer patch.
 
@@ -71,8 +79,8 @@ keeps that branding, and the UI hides a bar with nothing in it. When using
 even with `phone-bar-title="none"`. Pages outside the tab bar and detail pages
 with Back keep their title bar. `header-actions` share one "…" menu; only an
 entry marked `primary: true`, or a sole entry with an icon, becomes a separate
-bar button. The template's `#actions` stays page actions; no title or empty-bar
-workaround is needed.
+bar button. The template's `#actions` holds only real page actions; no title or
+empty-bar workaround is needed.
 
 `AppShell`'s `app-root` wraps it in an app-local `AppRoot` (app modal scope, on
 a full page as well, bounded at `height: 100%`) with the UI locale from

package/templates/native-rust/dsm-package.yaml

@@ -85,9 +85,12 @@ capabilities: {}
 # generated scripts/backup/ as root: a fixed script that only switches to the
 # package account. See `synopkgland skill show backup`.
 # backup:
-#   online: false          # true keeps the App running; SQLite is snapshotted
+#   online: false          # true keeps the App running; SQLite is read in
+#                          # place. Other files are read as they are: a file
+#                          # being written meanwhile may be inconsistent
 #   data_version: "1.0"    # "major.minor"; a restore refuses newer data
 #   hook: bin/backup-hook  # optional packaged freeze/thaw executable
+#   exclude: [tmp]         # optional data-folder globs left out (scratch data)
 # To opt out, use only:
 # backup:
 #   hyper_backup: false

package/templates/native-rust-vue/README.md

@@ -45,7 +45,7 @@ bridge App's runtime serves.
 
 Use the installed `@synopackageland/ui` and its declared compatible patch range.
 `App.vue` lays the shell out with the SDK's `AppShell` (`@synopackageland/sdk/vue`):
-`pages` from `shellPages`, the page's buttons in `#actions` and the pages in its
+`pages` from `shellPages`, real page actions in `#actions` and the pages in its
 default slot. On desktop, the sidebar names the page: the shell shows no page title, puts
 `#actions` in a bar above the page and scrolls only the content; a settings
 page (`SectionTabs fill` or `SettingsPage`) keeps its tabs and footer in place
@@ -60,6 +60,14 @@ device-width viewport. Its full-page sidebar names the App with
 shows the signed-in DSM account and its role from `ctx.user`. See the ui's
 `docs/adaptive-layout.md`.
 
+The template puts no Refresh in `#actions`, and with nothing there `AppShell`
+draws no bar above the page. Data stays fresh without one: `ctx.reopen` reads
+the status, the panels and the portal again when the window is shown again,
+and showing the status page again reads it again. A failed read offers Retry
+beside its error. Sign out appears in `#actions` only when standalone login is
+on. Keep `#actions` for real page actions, such as Add; a section that needs a
+manual re-read gets its own action in that section, not a header Refresh.
+
 The frontend SDK and UI use patch ranges; the lockfile records the installed
 versions. Update the lockfile deliberately when taking a newer patch.
 
@@ -71,8 +79,8 @@ keeps that branding, and the UI hides a bar with nothing in it. When using
 even with `phone-bar-title="none"`. Pages outside the tab bar and detail pages
 with Back keep their title bar. `header-actions` share one "…" menu; only an
 entry marked `primary: true`, or a sole entry with an icon, becomes a separate
-bar button. The template's `#actions` stays page actions; no title or empty-bar
-workaround is needed.
+bar button. The template's `#actions` holds only real page actions; no title or
+empty-bar workaround is needed.
 
 `AppShell`'s `app-root` wraps it in an app-local `AppRoot` (app modal scope, on
 a full page as well, bounded at `height: 100%`) with the UI locale from