@agentwhy/cli 0.1.0 → 0.2.1

package/dist/report/start/conversations/period-section.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, LANGS, TABLES, translator } from '../../render/report-copy.js';
 import { APP_SIDEBAR_STYLE } from '../../render/ui/app-sidebar.js';

package/dist/report/start/conversations/periods-script.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 /**
  * What the pages read through periods do with a script - Conversations, a week at a time, and This month
  * (`for-people-who-build-with-ai.md` F10-F14; `.ai/plans/2026-09-23-month-redesign.md`): one period shown at a time, a

package/dist/report/start/conversations/periods.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { TO_DO_LABELS } from '../../check/check-lines.js';
 import { statusOf } from '../render/session-status.js';
 import { LOOKS } from '../../render/ui/status-look.js';

package/dist/report/start/conversations/week-view.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { rangeName, tileName } from '../../render/ui/local-date.js';
 import { inLanguages } from '../../render/report-copy.js';
 import { dayTile, periodSwitch } from './calendar-view.js';

package/dist/report/start/conversations/weeks.js

@@ -1,3 +1,5 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
 import { TO_DO_LABELS } from '../../check/check-lines.js';
 import { bucketed, conversationsOf, period } from './periods.js';
 /**

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

@@ -0,0 +1,94 @@
+import { printable } from '../../shared/printable.js';
+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 (SW10), else the welcome where
+     * this project is to meet it (AW1), else every conversation.
+     */
+    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 welcome = await this.#welcome(asked);
+        const url = asked !== undefined && found ? asked : `${base}${welcome?.file ?? '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` +
+                // AWD3's sentence, in the words a served run already prints: true whether or not anyone opens the address.
+                (welcome === undefined
+                    ? ''
+                    : `${opened ? 'Opened' : 'That address opens'} the welcome page, to set agentwhy up for ${printable(welcome.project)}.\n`) +
+                'It stops by itself 30 minutes after its last page is closed.\n',
+        };
+    }
+    /**
+     * AW1: the onboarding's file where this run's address is to name it. A conversation asked for is the person's own
+     * yes to that report and wins over a setup they did not ask for, as a served run's own page does (SW10).
+     */
+    async #welcome(asked) {
+        const { welcome } = this.#dependencies;
+        if (asked !== undefined || welcome === undefined || !(await welcome.opens()))
+            return undefined;
+        return { file: welcome.file, project: welcome.project };
+    }
+    /** 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-decision.js

@@ -0,0 +1,44 @@
+// Copyright 2026 Nessprim Karol Kozer
+// SPDX-License-Identifier: Apache-2.0
+import { join } from 'node:path';
+import { SETTINGS_FILES } from '../../../adapter/claude-code/contract/settings.js';
+import { notAProject } from '../../../setup/not-a-project.js';
+import { readSettingsFile, setUpBy } from '../settings-files.js';
+/**
+ * Whether a project's run should name the onboarding instead of the index (W23), and what else the page needs to know.
+ *
+ * Its one side effect is N6's: a project set up before this screen existed, or by hand, has its `done` line written
+ * here and silently, so that turning alerts off later never brings the onboarding back. Asking a second time for the
+ * same project writes no second line: that reading finds the first.
+ *
+ * Shared by every run that names a page - `start` itself, and `start --detach`, whose address is the only way a person
+ * reaches one (`2026-10-01-the-address-opens-the-welcome.md` AW1, extended to `--detach` on 2026-10-04).
+ */
+export async function welcomeIn(workingDirectory, asked) {
+    const { store, files, home, realHome, now } = asked;
+    const reading = await store.read();
+    // W24: the intro plays once per person - where no project of theirs has finished the onboarding.
+    const intro = !reading.anywhere && !reading.failed;
+    // which-project V7: in the home directory no project is being shown, so the onboarding opens at its project step,
+    // whatever the record says - after the welcome only for a person who has never finished one. Nothing here is set up
+    // and no record is kept of it: not even the silent `done` line below.
+    if (home !== undefined && notAProject(workingDirectory, home, realHome) !== undefined) {
+        return { opens: true, intro, setUp: false, ...(intro ? {} : { atProject: true }) };
+    }
+    if (reading.here)
+        return { opens: false, intro, setUp: true };
+    if (reading.failed)
+        return { opens: false, intro, setUp: false };
+    // A local file that cannot be read leaves what runs unknown, and the onboarding closed (as `#settingsNow` does).
+    const local = await readSettingsFile(files, join(workingDirectory, SETTINGS_FILES.directory, SETTINGS_FILES.local));
+    if (local === 'unreadable')
+        return { opens: false, intro, setUp: false };
+    const shared = await readSettingsFile(files, join(workingDirectory, SETTINGS_FILES.directory, SETTINGS_FILES.shared));
+    // N6, widened 2026-09-28 by the maintainer (which-project V10): a project where one of agentwhy's hooks runs, or whose
+    // settings block files, was set up - before this screen existed, or by hand - and is recorded so, silently.
+    if (setUpBy([local, shared])) {
+        await store.add(now());
+        return { opens: false, intro, setUp: true };
+    }
+    return { opens: true, intro, setUp: false };
+}

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,9 +72,15 @@ 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)]
+            ? [
+                warn('The page could not be served, so it was opened as a file: marks made on it are copied as commands.', view),
+                // PF4's way out, which `--detach` has always said and this run did not: a sandbox is the usual reason, and a
+                // person reading a file cannot finish a setup or make a mark on it.
+                dim('To open it live, run this command again outside the sandbox, or type npx @agentwhy/cli in a terminal.', view),
+            ]
             : []),
         dim(said.shared
             ? 'Shared view: session ids and the project path are not shown, and nothing above the project root appears in any report.'

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') };
 }
 /**