create-pmos 0.166.0 → 0.167.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-pmos",
-  "version": "0.166.0",
+  "version": "0.167.0",
   "description": "Scaffold the PMOS portable kit — run the PMOS product-management workflow (initiative → lane-fit spec → contract → build → three gates, with work-type lanes for features, research, maintenance, incidents, and content) entirely inside your own repo, with all state as git-versioned files. Includes `workflow-sweep`, which audits the state every board derives from and separates real defects from work you simply have not done. `create-pmos workspace` also installs + launches the local Terminal Workspace GUI. No database, no network, no telemetry.",
   "license": "MIT",
   "bin": {

package/payload/KIT-VERSION

@@ -1,3 +1,3 @@
-kernel-source: pmos@4ae0213
+kernel-source: pmos@23fe058
 assembled: 2026-10-12
 mode: vendor

package/payload/planning/evals/eval-calibration.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Eval calibration log"
 description: "Append-only record of every PM override of an evaluator verdict."
-generated: {by: process:create-pmos, at: "2026-10-12T13:44:56Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
 status: stable
 ---
 

package/payload/planning/okrs/health-budgets.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Health budgets"
 description: "Closed registry of health-budget anchors (D59), edited only by the PM."
-generated: {by: process:create-pmos, at: "2026-10-12T13:44:56Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
 status: stable
 ---
 

package/payload/state/discoveries.md

@@ -2,7 +2,7 @@
 type: Reference
 title: "Discoveries and friction log"
 description: "Append-only record of what runs discovered and where the process rubbed."
-generated: {by: process:create-pmos, at: "2026-10-12T13:44:56Z"}
+generated: {by: process:create-pmos, at: "2026-10-12T14:00:51Z"}
 status: stable
 ---
 

package/workspace/guide/validate-with-typesafe.md

@@ -112,7 +112,7 @@ The workspace reads the TypeSafe key only on this machine. After you save the ke
 If you have no TypeSafe key, a model on your computer can answer the same questions. Two models are supported. Both use the same interface as Jev.
 
 - **Winnow**: in a `winnow-inference` folder, run `python3 scripts/serve.py`. It uses port 8091. Winnow-12B needs about 16 GB of memory.
-- **Laya**: run `pip install "laya[serve]"`, then `laya-serve`. It uses port 8000. Laya is small and runs on a laptop.
+- **Laya**: in Settings, press **Set up Laya**. A terminal named Set up Laya opens with the commands typed in. Read them and press Enter. The first time, they install Laya into the PMOS data folder. Then Laya starts and uses port 8000. Laya is small and runs on a laptop. Laya stops when you close that terminal or restart the computer. Press **Set up Laya** again to start it.
 
 1. Start the model.
 2. Open Settings, then **Privacy and data**. Under **Local model if Jev is missing**, press **Winnow** or **Laya**.

package/workspace/lib/typesafe-settings.js

@@ -90,6 +90,20 @@ function status(stateDir, env = null) {
   return { present: false, source: null, local: null };
 }
 
+/** The commands that install Laya into its own folder under the runtime directory (once) and start it on loopback.
+ *  The workspace types them into a terminal and never runs them itself: the PM reads them and presses Enter (as D91's
+ *  Whisper setup does). A folder of its own avoids the system Python, which newer Macs refuse to install into. */
+function layaSetupCommand(stateDir, platform = process.platform) {
+  const dir = path.join(stateDir, 'laya');
+  const port = typesafe.BACKENDS.laya.port;
+  if (platform === 'win32') {
+    return `if (-not (Test-Path "${dir}\\Scripts\\laya-serve.exe")) { python -m venv "${dir}"; & "${dir}\\Scripts\\python" -m pip install "laya[serve]" }; `
+      + `$env:LAYA_HOST="127.0.0.1"; $env:LAYA_PORT="${port}"; $env:LAYA_DEVICE="cpu"; $env:LAYA_PRELOAD="1"; & "${dir}\\Scripts\\laya-serve"`;
+  }
+  return `[ -x "${dir}/bin/laya-serve" ] || { python3 -m venv "${dir}" && "${dir}/bin/python" -m pip install "laya[serve]"; } && `
+    + `LAYA_HOST=127.0.0.1 LAYA_PORT=${port} LAYA_DEVICE=cpu LAYA_PRELOAD=1 "${dir}/bin/laya-serve"`;
+}
+
 /** Save or clear the local fallback server. `backend` is 'winnow' or 'laya'; `port` defaults to that server's own. */
 function setLocal(stateDir, { backend, port } = {}) {
   const cur = read(stateDir);
@@ -163,4 +177,4 @@ function isExcluded(exclude, rel) {
   });
 }
 
-module.exports = { adoptEnv, status, getKey, setKey, clearKey, setLocal, getRepo, setRepo, isExcluded, ENV_NAME, FILE };
+module.exports = { adoptEnv, status, getKey, setKey, clearKey, setLocal, layaSetupCommand, getRepo, setRepo, isExcluded, ENV_NAME, FILE };

package/workspace/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pmos-workspace",
-  "version": "0.166.0",
+  "version": "0.167.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pmos-workspace",
-      "version": "0.166.0",
+      "version": "0.167.0",
       "license": "MIT",
       "dependencies": {
         "@xterm/addon-fit": "^0.11.0",

package/workspace/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmos-workspace",
-  "version": "0.166.0",
+  "version": "0.167.0",
   "private": true,
   "description": "PMOS Terminal Workspace — local companion hosting real PTYs beside the library and gates (D62)",
   "license": "MIT",

package/workspace/public/pm/c3-settings.js

@@ -618,14 +618,24 @@ export function mountSettings(host, ctx = {}) {
       M.localTest = r && r.ok ? { ok: true, text: 'Answered (' + (r.model || r.local) + ').' } : { ok: false, text: (r && r.error) || 'No answer.' };
       draw();
     };
+    const setup = async () => {
+      M.localTest = { busy: true }; draw();
+      const r = await pmPost('/api/typesafe/local/setup', {});
+      if (r && r.ok) {
+        M.typesafe = r.key; delete M.err['typesafe.local'];
+        M.localTest = { ok: !!r.started, text: r.started ? 'A terminal named Set up Laya opened with the commands typed in. Press Enter there, wait until Laya says it is running, then press Test.' : 'No terminal opened (' + (r.reason || 'unknown') + '). Run this in a terminal: ' + r.command };
+      } else { M.localTest = null; M.err['typesafe.local'] = (r && r.error) || 'Not started.'; }
+      draw();
+    };
     const lt = M.localTest;
     const note = !loc ? 'Off. With no TypeSafe key, Jev features stay off.'
       : (t.source === 'local' ? 'No TypeSafe key, so ' + loc.name + ' answers every Jev question.' : 'TypeSafe answers first; ' + loc.name + ' answers when it fails.')
         + ' PMOS calls 127.0.0.1:' + loc.port + ' only. Nothing leaves this computer.' + (lt && !lt.busy ? ' ' + lt.text : '');
-    return frame({ key: 'typesafe.local', label: 'Local model if Jev is missing', help: 'Start Winnow (winnow-inference, port 8091) or Laya (laya-serve, port 8000) on this computer, then pick it here.', scope: 'computer',
+    return frame({ key: 'typesafe.local', label: 'Local model if Jev is missing', help: 'Press Set up Laya to install and start Laya in a terminal, or start Winnow (winnow-inference, port 8091) yourself and pick it here.', scope: 'computer',
       err: M.err['typesafe.local'], note,
       control: t ? el('div', { class: 'iacts' }, seg('Local model', [['off', 'Off'], ['winnow', 'Winnow'], ['laya', 'Laya']], cur, pick),
-        loc ? btn(lt && lt.busy ? 'Testing' : 'Test', { variant: 'ghost', disabled: !!(lt && lt.busy), onclick: test }) : null) : tag('Reading') });
+        btn('Set up Laya', { variant: 'ghost', disabled: !!(lt && lt.busy), onclick: setup, attrs: { 'data-c3set-laya-setup': '' } }),
+        loc ? btn(lt && lt.busy ? 'Working' : 'Test', { variant: 'ghost', disabled: !!(lt && lt.busy), onclick: test }) : null) : tag('Reading') });
   }
 
   function appearanceSec() {

package/workspace/server.js

@@ -7976,6 +7976,17 @@ async function handleRequest(req, res) {
     if (!out.ok) return json(res, { ok: false, error: out.error }, /choose|port/.test(out.error) ? 400 : 500);
     return json(res, { ok: true, key: tsSettings.status(STATE) });
   }
+  /* Set up Laya: picks Laya as the local model and opens a terminal with the install-and-start commands typed in, not run.
+   * The PM reads them and presses Enter; Laya then runs in that terminal on 127.0.0.1:8000 (D95). */
+  if (p === '/api/typesafe/local/setup' && req.method === 'POST') {
+    const saved = tsSettings.setLocal(STATE, { backend: 'laya' });
+    if (!saved.ok) return json(res, { ok: false, error: saved.error }, 500);
+    const command = tsSettings.layaSetupCommand(STATE);
+    const home = homeWorkspace();
+    const s = spawnSession({ name: 'Set up Laya', agent: 'shell', ws: home ? home.id : undefined, origin: 'laya-setup', initialInput: command });
+    const started = !!s && s.state !== 'exited';
+    return json(res, { ok: true, started, session: s ? s.id : null, command, key: tsSettings.status(STATE), reason: started ? '' : ((s && s.note) || 'could not start a terminal') });
+  }
   if (p === '/api/typesafe/local/test' && req.method === 'POST') {
     if (!tsSettings.status(STATE).local) return json(res, { ok: false, error: 'No local model is set.' }, 409);
     const r = await tsClient.ask({ key: tsClient.LOCAL_KEY, state: 'PMOS is checking that the local model answers.', retries: 0,