docs: sync package-template with latest hello-world, plus template fixes

- bump start-sdk 1.5.2 → 1.5.3 (package.json, lockfile)
- s9pk.mk: install deps with npm ci only; drop lockfile-regen rule
- set version 1.0.0:0 with "Initial release for StartOS" notes (all locales)
- ship startos/interfaces.ts returning an empty list, wired into init
- replace MIT LICENSE with a TODO placeholder + matching TODO.md item
- expand assets/README.md to explain what belongs in assets/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: MattDHill

packaging/package-template/LICENSE

@@ -1,21 +1,2 @@
-MIT License
-
-Copyright (c) 2024 Start9 Labs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+TODO: Replace this file with your package's license, and set the matching
+`license` field in startos/manifest/index.ts.

packaging/package-template/TODO.md

@@ -12,6 +12,8 @@ them, and add items when you defer work.
 
 - [ ] `startos/manifest/index.ts`: fill in `packageRepo`, `upstreamRepo`, and
       `marketingUrl` / `donationUrl` (or remove the latter two). Confirm the `license`.
+- [ ] Replace the placeholder `LICENSE` file with your package's license, matching the
+      `license` field in `startos/manifest/index.ts`.
 - [ ] `startos/manifest/i18n.ts`: write the short and long descriptions, then translate
       them into the other locales.
 - [ ] Replace `icon.svg` with a real {{name}} icon (≤ 40 KiB).
@@ -28,9 +30,9 @@ them, and add items when you defer work.
 - [ ] `startos/main.ts`: define the daemon(s) and any oneshots. Enable the commented-out
       `ready` health check (or add a standalone one), and add its strings to
       `startos/i18n/dictionaries` — only the keys actually referenced should remain there.
-- [ ] Interfaces: the barebones template ships none. If the service exposes a network
-      interface, add `startos/interfaces.ts` (`setupInterfaces`) and wire its `setInterfaces`
-      into `startos/init/index.ts` (see `start-docs/packaging/src/interfaces.md`).
+- [ ] Interfaces: `startos/interfaces.ts` ships wired into `startos/init/index.ts` but
+      returns an empty list. If the service exposes a network interface, bind a port and
+      export the interface there (see `start-docs/packaging/src/interfaces.md`).
 - [ ] `startos/backups.ts`: choose what to back up.
 - [ ] `startos/dependencies.ts`: declare any dependencies (or confirm none).
 - [ ] `startos/actions/`: add user-facing actions / config as needed.

packaging/package-template/assets/README.md

@@ -1 +1,18 @@
-Use the `/assets` directory to include additional files or scripts needed by your service.
+# assets/
+
+Supplementary files that ship inside the `.s9pk` alongside your compiled code —
+anything the service needs at runtime that isn't part of the upstream image.
+Typical contents:
+
+- entrypoint or wrapper scripts the daemon execs,
+- configuration templates / generators,
+- static files (default configs, seed data, certificates),
+- an `ABOUT.md` or other docs you want bundled.
+
+To make these files visible inside a container, mount them in `startos/main.ts`
+with `sdk.Mounts.…mountAssets(…)` and exec against the mountpoint (see the
+Volume Mounts section of `start-docs/packaging/src/main.md`).
+
+This directory is **required and must not be empty** — the build fails and git
+won't track an empty directory. This README satisfies that requirement, so don't
+delete it unless you're adding real assets to replace it.

packaging/package-template/package-lock.json

@@ -6,7 +6,7 @@
     "check": "tsc --noEmit"
   },
   "dependencies": {
-    "@start9labs/start-sdk": "1.5.2"
+    "@start9labs/start-sdk": "1.5.3"
   },
   "devDependencies": {
     "@types/node": "^22.19.0",

packaging/package-template/package.json

@@ -130,12 +130,9 @@ javascript/index.js: $(shell find startos -type f) tsconfig.json node_modules
 	npm run check
 	npm run build
 
-node_modules: package-lock.json
+node_modules: package-lock.json package.json
 	npm ci
 
-package-lock.json: package.json
-	npm i
-
 clean:
 	@echo "Cleaning up build artifacts..."
 	@rm -rf $(PACKAGE_ID).s9pk $(PACKAGE_ID)_x86_64.s9pk $(PACKAGE_ID)_aarch64.s9pk $(PACKAGE_ID)_riscv64.s9pk javascript node_modules

packaging/package-template/s9pk.mk

@@ -1,15 +1,14 @@
 import { sdk } from '../sdk'
 import { setDependencies } from '../dependencies'
+import { setInterfaces } from '../interfaces'
 import { versionGraph } from '../versions'
 import { actions } from '../actions'
 import { restoreInit } from '../backups'
 
-// This package defines no interfaces, so `setInterfaces` is omitted. When you
-// add startos/interfaces.ts, import its `setInterfaces` and insert it here,
-// conventionally before `setDependencies`.
 export const init = sdk.setupInit(
   restoreInit,
   versionGraph,
+  setInterfaces,
   setDependencies,
   actions,
 )

packaging/package-template/startos/init/index.ts

@@ -0,0 +1,7 @@
+import { sdk } from './sdk'
+
+// This package exposes no network interfaces, so it returns an empty list. To
+// add one, bind a port with a host (e.g. `sdk.MultiHost.of(...)`), create an
+// interface with `sdk.createInterface`, export it, and return its receipt(s)
+// here. See start-docs/packaging/src/interfaces.md.
+export const setInterfaces = sdk.setupInterfaces(async () => [])

packaging/package-template/startos/interfaces.ts

@@ -1,13 +1,13 @@
 import { IMPOSSIBLE, VersionInfo } from '@start9labs/start-sdk'
 
 export const current = VersionInfo.of({
-  version: '2.0.0:6',
+  version: '1.0.0:0',
   releaseNotes: {
-    en_US: 'Bumps start-sdk → 1.5.2.',
-    es_ES: 'Actualiza start-sdk → 1.5.2.',
-    de_DE: 'Aktualisiert start-sdk → 1.5.2.',
-    pl_PL: 'Aktualizuje start-sdk → 1.5.2.',
-    fr_FR: 'Met à jour start-sdk → 1.5.2.',
+    en_US: 'Initial release for StartOS',
+    es_ES: 'Lanzamiento inicial para StartOS',
+    de_DE: 'Erstveröffentlichung für StartOS',
+    pl_PL: 'Pierwsze wydanie dla StartOS',
+    fr_FR: 'Version initiale pour StartOS',
   },
   migrations: {
     up: async ({ effects }) => {},