@agentwhy/cli 0.0.0-dev → 0.2.0

package/dist/report/start/detached-start.js

@@ -0,0 +1,75 @@
+import { quietlySaid } from './render/start-words.js';
+/**
+ * How long a server started in the background is waited for, at most, while its process runs (PF3): its first pages are
+ * every conversation of the project, and a project with many takes a while. A process that ended is not waited for -
+ * a sandbox, a port refused - and the pages are written as files at once.
+ */
+const WAIT_MS = 60_000;
+const ASK_EVERY_MS = 250;
+/**
+ * `start --detach` (`2026-10-02-a-page-not-a-file.md` PF3-PF5): the pages served, from a command that returns at once.
+ * A server already running for this project is used - its address stays the one the person has open; else one is
+ * started in the background and waited for; else, where none can start (a sandbox), the pages are written as files,
+ * as `--no-serve` writes them, and that is said with what to do.
+ */
+export class DetachedStart {
+    #dependencies;
+    constructor(dependencies) {
+        this.#dependencies = dependencies;
+    }
+    async run(options) {
+        const { servers, probe, background, project, clock, sleep } = this.#dependencies;
+        const known = await servers.read(project);
+        if (known !== undefined && (await probe.answers(`${known.url}index.html`)))
+            return this.#show(known.url, options, true);
+        const pid = await background.start(backgroundArgs(options));
+        if (pid !== undefined) {
+            for (const deadline = clock() + WAIT_MS; clock() < deadline; await sleep(ASK_EVERY_MS)) {
+                const started = await servers.read(project);
+                if (started?.pid === pid && (await probe.answers(`${started.url}index.html`)))
+                    return this.#show(started.url, options, false);
+                if (!background.running(pid))
+                    break;
+            }
+        }
+        return this.#asFiles(options);
+    }
+    /** The page asked for on a running server: the session's report where it serves one, else every conversation (SW10). */
+    async #show(base, options, reused) {
+        const { probe, browser } = this.#dependencies;
+        const asked = options.session === undefined ? undefined : `${base}${options.session}.html`;
+        const found = asked === undefined || (await probe.answers(asked));
+        const url = asked !== undefined && found ? asked : `${base}index.html`;
+        const opened = options.open && (await browser.open(url));
+        // A conversation asked for and not served is said in every output, never passed off as its report (SW10).
+        const missing = found ? '' : 'That conversation was not found here, so all conversations are served.\n';
+        // Not opened, a served page is still there to open: said as served, never as a file written.
+        if (options.quiet === true)
+            return { outcome: 'written', output: opened ? quietlySaid(url, true, found) : `${missing}Serving: ${url}\n` };
+        return {
+            outcome: 'written',
+            output: missing +
+                `${reused ? 'agentwhy was already running for this project' : 'agentwhy runs in the background for this project'}: ${url}\n` +
+                'It stops by itself 30 minutes after its last page is closed.\n',
+        };
+    }
+    /** PF4: no server came up - a sandbox, a refusal - so the pages are files, and what would serve them is said. */
+    async #asFiles(options) {
+        const written = await this.#dependencies.files.run({ ...options, serve: false });
+        return {
+            ...written,
+            output: 'agentwhy could not keep running in the background here, so the pages were written as files. To open them live, ' +
+                'run this command again outside the sandbox, or type npx @agentwhy/cli in a terminal.\n' + written.output,
+        };
+    }
+}
+/** What the server in the background is started with: the same choices, served, opening nothing of its own. */
+function backgroundArgs(options) {
+    return [
+        'start', '--serve', '--no-open', '--since', options.since.asked,
+        ...(options.out === undefined ? [] : ['--out', options.out]),
+        ...(options.policyPath === undefined ? [] : ['--policy', options.policyPath]),
+        ...(options.settingsPath === undefined ? [] : ['--settings', options.settingsPath]),
+        ...(options.session === undefined ? [] : ['--session', options.session]),
+    ];
+}

package/dist/report/start/month/month-view.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { dataTable } from '../../render/ui/data-table.js';
 import { closeButton, pill } from '../../render/ui/button.js';
 import { CLOSES, popup, popupFoot } from '../../render/ui/popup.js';

package/dist/report/start/onboarding/done.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { inLanguages } from '../../render/report-copy.js';
 import { BRAND_MARK } from '../../render/ui/brand-mark.js';
@@ -82,14 +84,18 @@ function nothing(done, links) {
             : '<div class="ob-good"><span class="ob-good-mark" aria-hidden="true">✓</span><span>' +
                 '<span class="ob-good-title">' + inLanguages((t) => t('ob.done.good')) + '</span>' +
                 '<span class="ob-good-text">' + inLanguages((t) => t('ob.done.good.text', { when: when(t, done.asked) })) + '</span></span></div>') +
-        '<div class="ob-done-go">' + pill({ label: inLanguages((t) => t('ob.done.open')), tone: 'mint', size: 'lg', href: links.conversations }) + '</div>';
+        openAgentwhy(links);
 }
-/** W1a: no AI chats yet - set up before there is anything to show, and Settings the one page there is. */
+/** W1a: no AI chats yet - set up before there is anything to show, and then Conversations, where they will be listed. */
 function empty(links) {
     return '<h2 class="ob-h2 ob-done-title" id="ob-done-title"><span data-ob-if="on">' + inLanguages((t) => t('ob.done.protected')) + '</span>' +
         '<span data-ob-if="off" hidden>' + inLanguages((t) => t('ob.done.empty.title')) + '</span></h2>' +
         '<p class="ob-done-text">' + inLanguages((t) => t('ob.done.empty.text')) + '</p>' +
-        '<div class="ob-done-go">' + pill({ label: inLanguages((t) => t('ob.done.settings')), tone: 'mint', size: 'lg', href: links.settings }) + '</div>';
+        openAgentwhy(links);
+}
+/** W19, W1a: Done's own way on, to Conversations, whether or not there are chats in it yet. */
+function openAgentwhy(links) {
+    return '<div class="ob-done-go">' + pill({ label: inLanguages((t) => t('ob.done.open')), tone: 'mint', size: 'lg', href: links.conversations }) + '</div>';
 }
 /** "From now on, you'll be told right away." - or, where alerts end up off, how to turn them on (W18). */
 function told() {

package/dist/report/start/onboarding/finish-onboarding.js

@@ -24,11 +24,13 @@ export async function finishOnboarding(dependencies, choices) {
     for (const change of changes)
         results.push(await written(dependencies, change, choices.scope, telling));
     const recorded = await dependencies.store.add(dependencies.clock());
-    // W20a: read from the files as Finish left them - the writes above go through `CodexMirror`, which writes Codex's hook
-    // with Claude Code's `refuse` - and said only where Claude Code's block runs, so a project that blocks nothing is not
-    // told Codex isn't blocked.
+    // W20a: read from the files as Finish left them - the writes above go through `CodexMirror`, which writes agentwhy's
+    // Codex check with Claude Code's `refuse` - and said only where Claude Code's block runs, so a project that blocks
+    // nothing is not told Codex isn't blocked. `on` only where the check is verified (AO3): a write that did not verify
+    // reads as `off`, whose line says Settings can make it.
     const after = (await dependencies.settingsNow()).hooks;
-    const codex = after !== undefined && after.refuse !== false ? after.codex : undefined;
+    const state = after !== undefined && after.refuse !== false ? after.codex : undefined;
+    const codex = state === 'stale' ? 'off' : state;
     return { outcome: 'finished', results, recorded, ...(codex === undefined ? {} : { codex }) };
 }
 async function written(dependencies, change, scope, telling) {

package/dist/report/start/onboarding/intro.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { inLanguages } from '../../render/report-copy.js';
 /**
  * The intro (`.ai/specs/2026-09-24-onboarding.md` W4-W6): the problem told without a technical word, in about twelve

package/dist/report/start/onboarding/onboarding-renderer.js

@@ -43,7 +43,6 @@ export class OnboardingRenderer {
         });
     }
     #page(view, index) {
-        const anyConversation = index.entries.length > 0;
         // which-project V7: in the home directory there is no project to set up - only the step that picks one.
         const project = view.project.kind === 'none' ? undefined : view.project.name;
         const state = {
@@ -62,7 +61,7 @@ export class OnboardingRenderer {
             '<div class="ob-body">' + introScreen() + welcomeScreen() +
             projectStep(view, { now: index.now, timeZone: index.timeZone ?? 'UTC' }) +
             (project === undefined ? '' : stepScreens(view, project) + doneScreen(view.done, this.#links)) +
-            noScript(this.#links, anyConversation, project !== undefined) + '</div>' +
+            noScript(this.#links, project !== undefined) + '</div>' +
             (view.files.canAdd && project !== undefined ? addFilePopup(ADD_WINDOW) : '') +
             '</div>';
     }
@@ -84,13 +83,14 @@ function header() {
 /**
  * W27: without a script nothing here can be written, so the page says where the same choices are made - where there is a
  * project to make them for. In the home directory the project step already leads to its chats (which-project V7).
+ * Conversations is written for a project with no chats too (W1a, amended 2026-10-01), so both links are always there.
  */
-function noScript(links, anyConversation, aProject) {
+function noScript(links, aProject) {
     if (!aProject)
         return '';
     return '<div class="ob-nojs"><p>' + inLanguages((t) => t('ob.nojs')) + '</p><p class="ob-nojs-links">' +
         pill({ label: inLanguages((t) => t('ob.nojs.settings')), tone: 'primary', size: 'lg', href: links.settings }) +
-        (anyConversation ? pill({ label: inLanguages((t) => t('ob.nojs.conversations')), tone: 'outline', size: 'lg', href: links.conversations }) : '') +
+        pill({ label: inLanguages((t) => t('ob.nojs.conversations')), tone: 'outline', size: 'lg', href: links.conversations }) +
         '</p></div>';
 }
 /** What the script says, in every language: it cannot hold three languages in one text node. */

package/dist/report/start/onboarding/onboarding-script.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { INTRO_MS } from './intro.js';
 import { PICK_GROUP } from './project-step.js';
 /**

package/dist/report/start/onboarding/onboarding-view.js

@@ -91,7 +91,7 @@ function projectOf(index, read) {
     if (index.entries.length > 0)
         return { kind: 'found', name, ...place, conversations: index.entries.length, entryPoints: index.entryPoints ?? {}, read };
     const above = index.projects?.above;
-    const holder = above === undefined ? undefined : index.projects?.rows.find((row) => row.id === above.id && row.exists);
+    const holder = above === undefined ? undefined : index.projects?.rows.find((row) => row.id === above.id && row.folder !== 'gone');
     if (above !== undefined && holder !== undefined)
         return { kind: 'inside', name, ...place, above: holder, within: above.within };
     return { kind: 'empty', name, ...place };

package/dist/report/start/onboarding/project-step.js

@@ -7,7 +7,7 @@ import { tag } from '../../render/ui/tag.js';
 /** The radio group the step's list chooses in (`.ai/specs/2026-09-27-which-project.md` V11). */
 export const PICK_GROUP = 'ob-project';
 /** The kinds V4 names, in the order the step says them; an unknown kind is counted last and not named. */
-const NAMED = ['editor', 'terminal', 'script'];
+const NAMED = ['editor', 'terminal', 'desktop', 'script'];
 /** A small folder, drawn: the guidelines have no emoji, not even in a button (§9.3). */
 const FOLDER_SVG = '<svg viewBox="0 0 24 24" width="17" height="17" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linejoin="round" aria-hidden="true">' +
     '<path d="M3 6.5A1.5 1.5 0 0 1 4.5 5h4.2l2 2.2h8.8A1.5 1.5 0 0 1 21 8.7v9.8a1.5 1.5 0 0 1-1.5 1.5h-15A1.5 1.5 0 0 1 3 18.5z"/></svg>';

package/dist/report/start/onboarding/steps.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { inLanguages, labelAttributes } from '../../render/report-copy.js';
 import { pill, textButton, trashButton } from '../../render/ui/button.js';

package/dist/report/start/onboarding/welcome.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { inLanguages } from '../../render/report-copy.js';
 import { pill } from '../../render/ui/button.js';
 /**

package/dist/report/start/page-notice.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { updateNotice } from '../render/ui/update-notice.js';
 /**
  * What a page `start` serves draws over its content, from the model it is written with: the update notice, where the

package/dist/report/start/projects/index-projects.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { join, relative } from 'node:path';
 import { SETTINGS_FILES } from '../../../adapter/claude-code/contract/settings.js';
 import { projectDirectoryName } from '../../../adapter/claude-code/contract/projects.js';
@@ -15,12 +17,13 @@ export async function indexProjects(listing, sources) {
     const listed = temporary === undefined ? projects : projects.filter((project) => !temporary(project.path));
     const finished = await sources.onboarding?.doneFor(listed.map((project) => projectDirectoryName(project.path)));
     const rows = await Promise.all(listed.map(async (project) => {
-        const setUp = project.exists ? await setUpIn(project, sources.files, finished) : undefined;
+        // V10b: a folder not looked at is not read for its settings either.
+        const setUp = project.folder === 'there' ? await setUpIn(project, sources.files, finished) : undefined;
         return {
             id: project.id,
             place: homeRelative(project.path, sources.home),
             name: projectName(project.path),
-            exists: project.exists,
+            folder: project.folder,
             conversations: project.conversations,
             newest: project.newest,
             ...(setUp === undefined ? {} : { setUp }),

package/dist/report/start/projects/moved-page.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { INDEX_CONTENT_SECURITY_POLICY_META } from '../../render/html-head.js';
 import { inLanguages, LANGS, translator } from '../../render/report-copy.js';

package/dist/report/start/projects/project-switch.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { inLanguages, LANGS, translator } from '../../render/report-copy.js';
 import { pill } from '../../render/ui/button.js';

package/dist/report/start/projects/projects-window.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { inLanguages, labelAttributes } from '../../render/report-copy.js';
 import { BUTTON_STYLE, closeButton, pill } from '../../render/ui/button.js';

package/dist/report/start/projects/temporary-space.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { isAbsolute, relative, sep } from 'node:path';
 /** Where systems keep what is thrown away: `/tmp`, and on macOS the per-person folders `TMPDIR` points into. */
 const SYSTEM_TEMPORARY = ['/tmp', '/private/tmp', '/var/tmp', '/private/var/tmp', '/var/folders', '/private/var/folders'];

package/dist/report/start/render/start-words.js

@@ -1,9 +1,22 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { paint } from '../../../shared/colour.js';
 import { printable } from '../../../shared/printable.js';
 import { TAGLINE, terminalLogo } from '../../../shared/terminal-logo.js';
 const INDENT = '  ';
 /** The mark a heading carries, as the report draws it (§4.1). It stands beside the word, never instead of it. */
 const HEADING = '▍';
+/**
+ * What `start --quiet` says (`2026-10-02-said-where-the-person-is.md` SW11): where the page is and whether it opened,
+ * nothing a report found. Its reader is the agent that ran it because the person said yes to a report, as for `report
+ * --quiet` (`the-agent-tells-you` R19). A conversation asked for and not found is said, never passed off as its report.
+ */
+export function quietlySaid(place, opened, found) {
+    const where = printable(place);
+    if (!found)
+        return `That conversation was not found here, so all conversations were ${opened ? 'opened' : 'written'}: ${where}\n`;
+    return opened ? `Opened: ${where}\n` : `Written: ${where}\n`;
+}
 /**
  * Everything `start` says about one run: the wordmark, then what the range needs, then where the page is. The
  * sentences are the ones this command has always printed - the heading and the indent are what group them, so a
@@ -59,7 +72,8 @@ function page(said, view) {
                 `${dim('Serving the page at', view)} ${bold(said.url, view)}`,
                 dim('A mark made on it is recorded at once. It stops after 30 minutes with no request, or with Ctrl+C.', view),
             ]),
-        ...(said.welcome === true ? [`Opened the welcome page, to set agentwhy up for ${said.project ?? 'this project'}.`] : []),
+        ...(said.welcome === 'opened' ? [`Opened the welcome page, to set agentwhy up for ${said.project ?? 'this project'}.`] : []),
+        ...(said.welcome === 'served' ? [`That address opens the welcome page, to set agentwhy up for ${said.project ?? 'this project'}.`] : []),
         ...(said.servedAsFile === true
             ? [warn('The page could not be served, so it was opened as a file: marks made on it are copied as commands.', view)]
             : []),

package/dist/report/start/repository.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { dirname, join } from 'node:path';
 import { FileAccessError } from '../../ports/file-access-error.js';
 /**

package/dist/report/start/serve/index-handler.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { ALERT_THRESHOLDS } from '../../watch/agent-alert.js';
 import { CLEAN_MODES, NOTICE_CHANNELS, NOTICE_LANGS, SAID_AS } from '../../watch/notice-choices.js';
 import { isMarkResult, MARK_RESULTS } from '../../../ports/mark-store.js';
@@ -257,7 +259,8 @@ function settingsChange(fields) {
         }
         if (Object.keys(rules).length === 0)
             return 'An uninstall names the files it takes agentwhy out of.';
-        return { change: 'uninstall', rules };
+        // AO17: the window's unticked choice - out of the person's own Codex files too. Anything but true is unticked.
+        return { change: 'uninstall', rules, ...(fields.codex === true ? { codex: true } : {}) };
     }
     // The same rule, in the other file. `where` is the destination and is required here: a move with no file named
     // is not a move. A hook is moved by a `hooks` change instead, which names the file it is to run from.

package/dist/report/start/serve/settings-setup.js

@@ -112,6 +112,16 @@ async function uninstall(setup, change) {
             return { outcome: out.outcome, output: said.filter(Boolean).join('\n') };
         written ||= out.outcome === 'written';
     }
+    // AO17, ticked: agentwhy's check and its approvals out of the person's own Codex files too, after the project's part.
+    // `hooks: []` is the empty set, not silence: this run is Codex's alone, and the files the window named were already
+    // done above. Naming the two hooks here would take them out of the local file as well, which no tick asked for.
+    if (change.codex === true) {
+        const out = await setup.run({ protect: [], remove: true, yes: true, codex: true, hooks: [] });
+        said.push(out.output.trim());
+        if (out.outcome !== 'written' && out.outcome !== 'unchanged')
+            return { outcome: out.outcome, output: said.filter(Boolean).join('\n') };
+        written ||= out.outcome === 'written';
+    }
     return { outcome: written ? 'written' : 'unchanged', output: said.filter(Boolean).join('\n') };
 }
 /**

package/dist/report/start/session-start.js

@@ -1,7 +1,10 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { dirname, join, relative, resolve } from 'node:path';
-import { sessionKey } from '../../core/session-catalogue.js';
+import { noStoreAnywhere, sessionKey } from '../../core/session-catalogue.js';
 import { splitBySince } from '../../core/session-filter.js';
 import { recogniseAll } from '../../core/session-titles.js';
+import { isDirectory } from '../../ports/directory-reader.js';
 import { FileAccessError } from '../../ports/file-access-error.js';
 import { contentVersion } from '../../shared/content-version.js';
 import { fileStamp } from '../../shared/file-stamp.js';
@@ -21,6 +24,7 @@ import { indexProjects } from './projects/index-projects.js';
 import { NOT_A_PROJECT } from '../../setup/project-setup.js';
 import { notAProject } from '../../setup/not-a-project.js';
 import { inTemporarySpace } from './projects/temporary-space.js';
+import { inChatFolder } from '../../adapter/codex/contract/chat-folders.js';
 import { behind } from '../../setup/behind.js';
 import { modeChange, onlyTakesOut, settingsChangeToSetup } from './serve/settings-setup.js';
 import { DEFAULT_THRESHOLD } from '../watch/agent-alert.js';
@@ -29,13 +33,15 @@ import { actionsAfterMarks, markLines, marksInRange, standingMarks } from '../ch
 import { finishOnboarding } from './onboarding/finish-onboarding.js';
 import { WHO_STEP } from './onboarding/onboarding-script.js';
 import { repositoryAbove } from './repository.js';
-import { pageStopped, startSaid } from './render/start-words.js';
+import { pageStopped, quietlySaid, startSaid } from './render/start-words.js';
 import { PROJECT_HOOKS } from '../../adapter/codex/contract/hooks.js';
+import { codexCheckState } from '../../adapter/codex/settings/codex-check.js';
 import { codexRefuseIn } from '../../adapter/codex/settings/codex-hooks.js';
 import { SETTINGS_FILES } from '../../adapter/claude-code/contract/settings.js';
 import { rulesReadByHooks } from '../../adapter/claude-code/settings/hook-entries.js';
 import { fileRulesIn, isDenied } from '../../adapter/claude-code/settings/deny-entries.js';
 import { fileRulePathOf, toPattern } from '../../adapter/claude-code/policy/deny-rules.js';
+import { nothingSavedHere } from '../nothing-saved-here.js';
 const DAY = 86_400_000;
 /**
  * The patterns the page lists: the ones the policy read, and then any rule the project's own settings files hold
@@ -91,12 +97,19 @@ export class SessionStart {
         // which-project V16: a run the onboarding's project step switched to opens that project's onboarding, whatever W23
         // says - the person is in the middle of a setup, and the step chose this project for it.
         const arrivedFrom = this.#dependencies.arrivedFrom;
-        const opensWelcome = welcome !== undefined && (arrivedFrom === 'step' || (options.open && welcome.opens));
+        // AW1 (`the-address-opens-the-welcome`): an address asked for with `--serve` is opened by a person - the one an AI app
+        // sends - so it names the page a browser this run opened would show. Not in an empty project (AW2): every empty
+        // listing seen there came from a place that cannot see the person's conversations, whose address nobody can open.
+        const anyConversation = listing.found && listing.sessions.length > 0;
+        const opensWelcome = welcome !== undefined && (arrivedFrom === 'step' || ((options.open || (options.serve === true && anyConversation)) && welcome.opens));
         if ((!listing.found || listing.sessions.length === 0) && !opensWelcome) {
             return {
                 outcome: 'no-sessions',
                 // Every place looked in, one per AI: "looked in the wrong place" is only answerable where each is named.
-                output: noSessions(listing.searched.map((place) => place.directory).join(' and ') || listing.directory, projectName(workingDirectory), served && options.open, welcome?.setUp === true, notHere),
+                // R28, amended 2026-10-01: at a terminal only - a run that would open a page keeps W1a's words, naming no command.
+                output: noStoreAnywhere(listing) && notHere === undefined && !(served && options.open)
+                    ? nothingSavedHere('Claude Code or Codex', listing.searched.map((place) => place.directory).join(' and '), 'use Claude Code or Codex here, then run agentwhy start again - or run agentwhy init now, to be protected in Claude Code before there is history to check.')
+                    : noSessions(listing.searched.map((place) => place.directory).join(' and ') || listing.directory, projectName(workingDirectory), served && options.open, welcome?.setUp === true, notHere),
             };
         }
         // Resolved against the working directory given, never against whatever the process happens to be standing in.
@@ -125,6 +138,9 @@ export class SessionStart {
         // F55: a conversation a person once asked to check is read by every run after, as if it were in range - the button is
         // pressed once, not every morning. A list that cannot be read leaves the run its range, as it always had.
         const asked = new Set(this.#dependencies.checked === undefined ? [] : (await this.#dependencies.checked.read()).ids);
+        // SW10: the conversation a run was asked to open is written however long ago it was active. Not recorded as checked.
+        if (options.session !== undefined)
+            asked.add(options.session);
         // M5: each report is drawn with the marks that still hold for its session. A shared page carries none (R37), and a
         // record that cannot be read leaves every file to do rather than guessing which were done (invariant 4).
         const standingAtStart = options.share ? new Map() : standingMarks((await this.#dependencies.marks.read()).records);
@@ -160,14 +176,15 @@ export class SessionStart {
             const { inRange, outOfRange: older } = splitBySince(sessions, options.since.since);
             const generatedIds = new Set([...inRange, ...older.filter((session) => asked.has(sessionKey(session)))].map((session) => sessionKey(session)));
             // A title is user content, and a shared page is one that leaves this machine: it is not even read. A session that
-            // has grown may have a new last prompt, so its title is read again with it. A Codex conversation is named in a file
-            // of Codex's own, seconds after it starts (`what-codex-wrote` §2.9, X28a) - found by the maintainer, a row drawn in
-            // those seconds stayed untitled once its rollout stopped changing - so a Codex row with no title asks again; the
-            // names are a lookup in a list read again only where it changed.
+            // has grown may have a new last prompt, so its title is read again with it. Both desktop apps name a conversation
+            // in a file of their own, seconds after it starts (`what-codex-wrote` §2.9, X28a; `claude-desktop-conversations`
+            // CD5) - found by the maintainer, a row drawn in those seconds stayed untitled once its transcript stopped
+            // changing - so a row with no title asks again. That ask is a lookup in the app's own names, read again only
+            // where they changed; the adapter keeps an unchanged transcript's tail, so it is not read again (CD5).
             if (!options.share) {
                 const stale = sessions.filter((session) => {
                     const known = titles.get(sessionKey(session));
-                    return known?.modifiedAt !== session.modifiedAt || (session.provider === 'codex' && known.title === undefined);
+                    return known?.modifiedAt !== session.modifiedAt || known.title === undefined;
                 });
                 const read_ = await recogniseAll(this.#dependencies.titles, stale);
                 stale.forEach((session, at) => titles.set(sessionKey(session), { modifiedAt: session.modifiedAt, ...read_[at] }));
@@ -365,7 +382,9 @@ export class SessionStart {
         /*
          * R75: the conversations and the marks as they are now, drawn into every page. A page read while a refresh runs is
          * answered by that refresh; a write is not, because the refresh it would join began before the write - it waits,
-         * then runs again. A listing that finds nothing now (a directory moved, a disk gone) leaves the pages as they were.
+         * then runs again. A listing that finds nothing now (a directory moved, a disk gone) leaves the conversations as
+         * they were, and the pages are still drawn again: Settings shows what the files hold (R60), in a project with no
+         * conversations yet too (W1a).
          */
         let refreshing;
         const refresh = async (when) => {
@@ -375,16 +394,16 @@ export class SessionStart {
                 await refreshing;
             const running = (async () => {
                 const now_ = await catalogue.list(workingDirectory);
-                if (!now_.found || now_.sessions.length === 0)
-                    return undefined;
-                // A policy that cannot be read now leaves the one the pages were drawn under, rather than rules nobody chose.
-                const again = await choosePolicy(options, policyFiles, this.#dependencies.tell).catch(() => undefined);
-                if (again !== undefined && !('errors' in again))
-                    policyNow = again.policy;
-                const refusal = await sync(now_.sessions, standingMarks((await this.#dependencies.marks.read()).records));
-                if (refusal !== undefined)
-                    return refusal;
-                reportsServed();
+                if (now_.found && now_.sessions.length > 0) {
+                    // A policy that cannot be read now leaves the one the pages were drawn under, rather than rules nobody chose.
+                    const again = await choosePolicy(options, policyFiles, this.#dependencies.tell).catch(() => undefined);
+                    if (again !== undefined && !('errors' in again))
+                        policyNow = again.policy;
+                    const refusal = await sync(now_.sessions, standingMarks((await this.#dependencies.marks.read()).records));
+                    if (refusal !== undefined)
+                        return refusal;
+                    reportsServed();
+                }
                 await writePages((await build()).index);
                 return undefined;
             })();
@@ -428,10 +447,14 @@ export class SessionStart {
             if (chosen !== undefined)
                 return switchToFolder(chosen, from);
             const project = listed?.projects.find((one) => one.id === id);
-            if (project === undefined || !project.exists || this.#notAProject(project.path) !== undefined)
+            if (project === undefined || project.folder === 'gone' || this.#notAProject(project.path) !== undefined)
                 return { failed: 'That project is not one this page listed.' };
             if (relative(project.path, workingDirectory) === '')
                 return { failed: 'That project is the one shown already.' };
+            // which-project V10b: a folder the system guards was not looked into while listing; it is now, because the person
+            // picked it - so the system asks them, if at all, about something they did.
+            if (project.folder === 'not-looked' && !(await isDirectory(this.#dependencies.directories, project.path)))
+                return { failed: 'This folder isn’t there anymore.' };
             return switchToFolder(project.path, from);
         };
         // V12: a folder chosen in the computer's window - shown at once where it is a project or near none, and where it lies
@@ -520,16 +543,23 @@ export class SessionStart {
                 },
             })
             : undefined;
+        // PF2: the address and its token, where a later `--detach` looks for a server to reuse. Never a shared page's.
+        if (serving !== undefined && !options.share)
+            await this.#dependencies.pageServer?.write(serving.urlOf(''));
         // W23: the onboarding is opened in place of the index where it is to be; the index otherwise, as it always was. A run
         // a page switched to opens it at *Who*: the project was chosen on the way here (which-project V16).
-        const openAt = serving === undefined ? indexPath
-            : opensWelcome && onboarding !== undefined ? serving.urlOf(onboarding.file) + (arrivedFrom === undefined ? '' : `#${WHO_STEP}`)
-                : serving.url;
+        // SW10: a conversation asked for by name is opened in its place - the person said yes to that report, not to a setup.
+        const wanted = options.session === undefined ? undefined : reports.get(options.session);
+        const sessionFile = wanted !== undefined && wanted.report.kind === 'generated' ? wanted.file : undefined;
+        const openAt = sessionFile !== undefined ? (serving === undefined ? join(out, sessionFile) : serving.urlOf(sessionFile))
+            : serving === undefined ? indexPath
+                : opensWelcome && onboarding !== undefined ? serving.urlOf(onboarding.file) + (arrivedFrom === undefined ? '' : `#${WHO_STEP}`)
+                    : serving.url;
         // V15: a run a page switched to is shown in that page's tab, so it opens none of its own.
         const handedOver = this.#dependencies.handedOver;
         const opened = options.open && handedOver === undefined ? await this.#dependencies.browser.open(openAt) : true;
         const view = this.#dependencies.terminal ?? { colour: false, decorated: false };
-        const said = startSaid({
+        const said = options.quiet === true ? quietlySaid(openAt, opened && options.open, options.session === undefined || sessionFile !== undefined) : startSaid({
             ...counted(entries, outOfRange.length, indexPath, first.index, opened),
             // which-project V3: the folder the run was for, said where the terminal says what it read.
             ...(options.share ? {} : { project: projectName(workingDirectory) }),
@@ -540,7 +570,8 @@ export class SessionStart {
                 ? { servedAsFile: true }
                 : {}),
             ...(serving === undefined ? {} : { url: openAt }),
-            ...(serving !== undefined && opensWelcome ? { welcome: true } : {}),
+            // AW3: "Opened" only where a browser or a page's tab shows it; an address handed on is said as one.
+            ...(serving !== undefined && opensWelcome ? { welcome: options.open || handedOver !== undefined ? 'opened' : 'served' } : {}),
             // which-project V3: a switch says which project is shown now, and where it is.
             ...(handedOver === undefined || options.share ? {} : { nowShowing: this.#dependencies.home === undefined ? projectName(workingDirectory) : `${projectName(workingDirectory)} (${homeRelative(workingDirectory, this.#dependencies.home)})` }),
         }, view);
@@ -550,6 +581,7 @@ export class SessionStart {
         printer?.write(said);
         handedOver?.(openAt);
         await serving.closed;
+        await this.#dependencies.pageServer?.remove();
         // V14: a run a page moved away from ends quietly - the run it moved to has already said what it shows.
         if (switchedAway)
             return { outcome: 'written', output: '' };
@@ -690,7 +722,8 @@ export class SessionStart {
             return {};
         const listing = await projects.list();
         const noProject = (path) => this.#notAProject(path) !== undefined;
-        const temporary = (path) => inTemporarySpace(path, this.#dependencies.temporaryDirectory, home);
+        // V10b: a folder the ChatGPT app made for a chat with no project is a quick try too, and counted with them.
+        const temporary = (path) => inTemporarySpace(path, this.#dependencies.temporaryDirectory, home) || inChatFolder(path, home);
         // V20: a folder with no conversations of its own, inside a project that has them - where they are.
         const near = nearestProject(workingDirectory, listing, noProject);
         const above = near.kind === 'above' ? { id: near.project.id, within: relative(near.project.path, workingDirectory) } : undefined;
@@ -788,9 +821,16 @@ export class SessionStart {
         // U2: the version is this run's own, read once; the hooks are read from the files as they are now.
         this.#serving ??= this.#dependencies.invocation?.version() ?? Promise.resolve(undefined);
         const late = behind({ ...(local === undefined ? {} : { local }), ...(readable === undefined ? {} : { shared: readable }) }, await this.#serving);
-        // CK8: Codex's hook file, read as the settings are; its state is drawn only where the project uses Codex (CK6).
+        // AO3: Codex's state is read, never assumed - `on` only where agentwhy's check in the person's own Codex files is
+        // verified as approved; `stale` where a check is written somewhere (the person's files unverified, or the old
+        // project-level copy) and Codex may still ask; `off` where the project uses Codex (CK6) and nothing is written.
         const codexHooks = await this.#settingsFile(join(workingDirectory, PROJECT_HOOKS.directory, PROJECT_HOOKS.file));
-        const codex = typeof codexHooks === 'object' && codexRefuseIn(codexHooks) !== undefined ? 'on' : codexListed || codexHooks !== undefined ? 'off' : undefined;
+        const check = this.#dependencies.home === undefined ? 'absent' : await codexCheckState(this.#dependencies.policyFiles, this.#dependencies.home);
+        const legacy = typeof codexHooks === 'object' && codexRefuseIn(codexHooks) !== undefined;
+        const codex = check === 'on' ? 'on'
+            : check === 'stale' || legacy ? 'stale'
+                : codexListed || codexHooks !== undefined || (await this.#dependencies.codexOnThisComputer?.()) === true ? 'off'
+                    : undefined;
         return {
             hooks: {
                 watch: installed('watch'),

package/dist/report/start/settings/alerts-tab.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { escapeHtml as e } from '../../render/html-report-components.js';
 import { inLanguages, labelAttributes } from '../../render/report-copy.js';
 import { textButton } from '../../render/ui/button.js';
@@ -78,7 +80,8 @@ function lockedSwitch(key, turnOn) {
         (turnOn === undefined ? '' : textButton(inLanguages((t) => t('set.need.go')), turnOn, 'set-tip-go')) +
         '</div></div>';
 }
-function stateLine(state) {
+/** A switch's state in words, under its row: shared with General's system notifications (SW13). */
+export function stateLine(state) {
     return '<div class="set-state' + (state.on ? ' set-state-on' : '') + '"><span class="set-dot" aria-hidden="true"></span>' +
         inLanguages((t) => t(state.key)) + '</div>';
 }