2026-10-18 15:39:24 -07:00
// Page tests for Help, the first-run Welcome and the update notice's modal. Run
// with:
// node --test scripts/test-web-console-page-help.mjs
//
// Each test drives the real console in a real Chrome or Edge through
// scripts/page-test-helpers.mjs: one browser for the file, a fresh console
// session per test. Help's prose stays untested; these cover how the dialog
// behaves.
import fs from "node:fs" ;
import path from "node:path" ;
import test from "node:test" ;
import assert from "node:assert/strict" ;
2026-11-03 03:59:50 -08:00
import { pageSuite , openSession , tempProject , textOf , drawn , fillBox } from "./page-test-helpers.mjs" ;
2026-10-25 12:46:52 -07:00
import { HOME , cli , until } from "./web-console-test-helpers.mjs" ;
2026-10-18 15:39:24 -07:00
import { HELP_TABS } from "../src/web-console/public/help.js" ;
2026-10-19 15:56:52 -07:00
import { CATALOG_GROUPS , SKILL_CATALOG } from "../src/web-console/public/answers.js" ;
2026-10-25 12:46:52 -07:00
import { GONE_AFTER_MS } from "../src/web-console/public/screens/core.js" ;
// The agent's side of `stop`, leaving the browser context open (s.stop()
// closes it, which would hide what the page does next).
async function stopServer ( s ) {
2026-11-02 12:00:12 -08:00
cli ([ "stop" , "--session" , s . sid , "--force" ], { cwd : s . project });
2026-10-25 12:46:52 -07:00
assert . ok ( await until ( async () => ! ( await s . answers ()), 5000 ), "the server still answers after stop" );
}
2026-10-18 15:39:24 -07:00
const suite = pageSuite ( test );
// The console home's saved looks, shared by every session of this file. Each
// test that cares sets it first and the file is removed once the test is done.
const LOOKS_FILE = path . join ( HOME , "looks.json" );
function savedLooks ( t , looks ) {
if ( looks ) fs . writeFileSync ( LOOKS_FILE , JSON . stringify ({ looks }));
else fs . rmSync ( LOOKS_FILE , { force : true });
t . after (() => fs . rmSync ( LOOKS_FILE , { force : true }));
}
const RELEASES_URL = "https://github.com/jparkerweb/plan2code/releases/" ;
// A plan session on the person's turn: one text question and the agent listening.
const PLAN_QUESTION = {
items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name for the export." }],
agent : { status : "waiting" },
};
// The dashboard, past Planny's wake-up. The Welcome may be on top of it. The
// wake-up plays once per tab, so a reloaded page has no intro to skip.
async function toTheDashboard ( s ) {
const heading = s . page . locator ( "#main" ). getByRole ( "heading" , { name : "What are we doing today?" });
const skip = s . page . getByRole ( "button" , { name : "Skip the intro" });
await skip . or ( heading ). first (). waitFor ();
if ( await skip . isVisible ()) await skip . click ();
await heading . waitFor ();
}
const helpModal = ( s ) => s . page . locator ( "#help-modal" );
const tabButton = ( s , id ) => s . page . locator ( "#help-tab-" + id );
const selectedTab = ( s ) => s . page . locator ( '#help-tabs [role="tab"][aria-selected="true"]' );
const focusedId = ( s ) => s . page . evaluate (() => document . activeElement && document . activeElement . id );
async function openHelp ( s ) {
await s . page . click ( "#btn-about" );
await helpModal ( s ). waitFor ();
}
test ( "Help opens on a tab, moves between tabs with the arrow, Home and End keys, and closes with Escape" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), { t , workflow : "plan" , payload : PLAN_QUESTION });
// Built on first open: the tab buttons are not in the page before it.
assert . equal ( await s . page . locator ( "#help-tabs [role=tab]" ). count (), 0 , "Help is built before it is opened" );
await openHelp ( s );
assert . equal ( await s . page . locator ( "#help-tabs [role=tab]" ). count (), HELP_TABS . length , "one tab button per Help topic" );
// A plain workflow page opens on the first topic, with focus on its tab.
const ids = HELP_TABS . map (( x ) => x . id );
assert . equal ( await selectedTab ( s ). count (), 1 , "exactly one tab is selected" );
assert . equal ( await selectedTab ( s ). getAttribute ( "id" ), "help-tab-" + ids [ 0 ]);
assert . equal ( await focusedId ( s ), "help-tab-" + ids [ 0 ], "focus starts on the selected tab" );
// Roving focus: only the selected tab is in the tab order, and its panel is the one shown.
const onlySelected = async ( id ) => {
assert . equal ( await selectedTab ( s ). getAttribute ( "id" ), "help-tab-" + id );
assert . equal ( await focusedId ( s ), "help-tab-" + id , `focus is on ${ id } ` );
assert . equal ( await tabButton ( s , id ). getAttribute ( "tabindex" ), "0" );
assert . equal ( await s . page . locator ( '#help-tabs [role=tab][tabindex="0"]' ). count (), 1 , "one tab stop" );
assert . equal ( await s . page . locator ( "#help-panel-" + id ). isVisible (), true , ` ${ id } 's panel is shown` );
assert . equal ( await s . page . locator ( '#help-panels [role=tabpanel]:not([hidden])' ). count (), 1 , "one panel is shown" );
};
await onlySelected ( ids [ 0 ]);
await s . page . keyboard . press ( "ArrowDown" );
await onlySelected ( ids [ 1 ]);
await s . page . keyboard . press ( "ArrowRight" );
await onlySelected ( ids [ 2 ]);
await s . page . keyboard . press ( "ArrowUp" );
await onlySelected ( ids [ 1 ]);
await s . page . keyboard . press ( "End" );
await onlySelected ( ids [ ids . length - 1 ]);
await s . page . keyboard . press ( "ArrowDown" );
await onlySelected ( ids [ 0 ]);
await s . page . keyboard . press ( "ArrowUp" );
await onlySelected ( ids [ ids . length - 1 ]);
await s . page . keyboard . press ( "Home" );
await onlySelected ( ids [ 0 ]);
// A click picks a tab too.
await tabButton ( s , ids [ 3 ]). click ();
await onlySelected ( ids [ 3 ]);
await s . page . keyboard . press ( "Escape" );
await helpModal ( s ). waitFor ({ state : "hidden" });
assert . equal ( await focusedId ( s ), "btn-about" , "focus goes back to the Help button" );
// Reopened, the built dialog is reused: no second set of tabs.
await openHelp ( s );
assert . equal ( await s . page . locator ( "#help-tabs [role=tab]" ). count (), HELP_TABS . length );
});
test ( "Help shows the live connection line and the version as a safe link to the Releases page" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), { t , workflow : "plan" , payload : PLAN_QUESTION });
await openHelp ( s );
const live = s . page . locator ( "#about-live" );
assert . match ( await textOf ( live ), /^Right now: both halves are talking to each other\./ );
assert . equal ( await live . evaluate (( n ) => n . classList . contains ( "is-good" )), true );
const link = s . page . locator ( "#help-version a" );
await link . waitFor ();
assert . match ( await textOf ( link ), /^Plan2Code v\d+\.\d+\.\d+/ , "the link names the installed version" );
assert . equal ( await link . getAttribute ( "href" ), RELEASES_URL );
assert . equal ( await link . getAttribute ( "rel" ), "noopener noreferrer" );
assert . equal ( await link . getAttribute ( "target" ), "_blank" );
// The line is written on open: a finished session says so the next time.
await s . page . keyboard . press ( "Escape" );
await helpModal ( s ). waitFor ({ state : "hidden" });
s . post ({ finish : { headline : "The plan is written" , command : "/plan2code-2-document" } });
await s . page . locator ( "#main" ). getByRole ( "heading" , { name : "The plan is written" }). waitFor ();
await openHelp ( s );
assert . match ( await textOf ( live ), /^Right now: the session is finished/ );
});
test ( "a click on Help's backdrop closes it, and a click inside it does not" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), { t , workflow : "plan" , payload : PLAN_QUESTION });
await openHelp ( s );
await s . page . locator ( "#help-title" ). click ();
assert . equal ( await helpModal ( s ). isVisible (), true , "a click inside closed Help" );
// The top-left corner of the page is the backdrop, well outside the dialog.
await s . page . mouse . click ( 4 , 4 );
await helpModal ( s ). waitFor ({ state : "hidden" });
});
test ( "Ctrl+Enter does not send while Help is open, and sends once it is closed" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), { t , workflow : "plan" , payload : PLAN_QUESTION });
2026-11-03 03:59:50 -08:00
await fillBox ( s . page . locator ( '[data-item="q1"]' ). first (). locator ( ".md-host, input[type=text]" ). first (), "audit-export" );
2026-10-18 15:39:24 -07:00
await openHelp ( s );
await s . page . keyboard . press ( "Control+Enter" );
await s . page . keyboard . press ( "Meta+Enter" );
assert . equal ( s . wait ( 1 ). code === 0 , false , "something was sent from behind Help" );
assert . equal ( await helpModal ( s ). isVisible (), true , "the key closed Help" );
await s . page . keyboard . press ( "Escape" );
await helpModal ( s ). waitFor ({ state : "hidden" });
await s . page . keyboard . press ( "Control+Enter" );
const got = s . wait ( 10 );
assert . equal ( got . code , 0 , "Ctrl+Enter sends nothing with Help closed" );
assert . deepEqual (
got . actions . map (({ i , type }) => ({ i , type })),
[{ i : "q1" , type : "answer" }]
);
});
test ( "the Welcome shows on a first dashboard, saves that it was seen, and Help's Show the welcome again brings it back" , async ( t ) => {
savedLooks ( t , null );
const s = await openSession ( await suite . browser (), { t , workflow : "dashboard" , payload : { agent : { status : "waiting" } }, project : tempProject () });
await toTheDashboard ( s );
const welcome = s . page . locator ( "#welcome-modal" );
await welcome . waitFor ();
assert . equal ( await s . page . locator ( "#welcome-title" ). isVisible (), true );
await s . page . getByRole ( "button" , { name : "Start building" }). click ();
await welcome . waitFor ({ state : "hidden" });
// Saved with the other looks, so it holds for the next page too.
2026-11-05 14:16:34 -08:00
// Polled from here: waitForFunction does not wait on an async predicate, so it passed before the POST landed.
assert . ok ( await until (() => s . page . evaluate ( async () => (( await ( await fetch ( "/looks" )). json ()). looks || {}). welcomeSeen === true )), "the Welcome being seen was saved" );
2026-10-18 15:39:24 -07:00
await s . page . reload ({ waitUntil : "domcontentloaded" });
await drawn ( s . page );
await toTheDashboard ( s );
await s . page . waitForTimeout ( 800 );
assert . equal ( await welcome . isVisible (), false , "the Welcome came back on a later page" );
// Help's first topic offers it again, and Help steps aside for it.
// (On the dashboard Help opens on the dashboard topic, so go to the first.)
await openHelp ( s );
await tabButton ( s , HELP_TABS [ 0 ]. id ). click ();
await s . page . getByRole ( "button" , { name : "Show the welcome again" }). click ();
await welcome . waitFor ();
assert . equal ( await helpModal ( s ). isVisible (), false , "Help stayed open under the Welcome" );
await s . page . keyboard . press ( "Escape" );
await welcome . waitFor ({ state : "hidden" });
});
test ( "the Welcome stays away when the person has seen it, and off the dashboard" , async ( t ) => {
const browser = await suite . browser ();
savedLooks ( t , { welcomeSeen : true });
const seen = await openSession ( browser , { t , workflow : "dashboard" , payload : { agent : { status : "waiting" } }, project : tempProject () });
await toTheDashboard ( seen );
await seen . page . waitForTimeout ( 800 );
assert . equal ( await seen . page . locator ( "#welcome-modal" ). isVisible (), false , "a seen Welcome showed again" );
// Unseen, but a workflow page is not a first dashboard.
savedLooks ( t , null );
const plan = await openSession ( browser , { t , workflow : "plan" , payload : PLAN_QUESTION });
await plan . page . waitForTimeout ( 800 );
assert . equal ( await plan . page . locator ( "#welcome-modal" ). isVisible (), false , "the Welcome showed on a workflow page" );
});
2026-10-19 15:56:52 -07:00
test ( "Help's dashboard topic lists every card once, grouped and in the dashboard's order, by its Help line or blurb" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), { t , workflow : "dashboard" , payload : { agent : { status : "waiting" } }, project : tempProject () });
await toTheDashboard ( s );
await openHelp ( s );
await tabButton ( s , "dashboard" ). click ();
const panel = s . page . locator ( "#help-panel-dashboard" );
await panel . waitFor ();
// Read back as drawn: each group's heading, then its list's title and line.
const drawnGroups = await panel . locator ( ".help-cards" ). evaluate (( box ) => {
const out = [];
for ( const node of box . children ) {
if ( node . tagName === "P" ) out . push ({ title : node . textContent , cards : [] });
else
out . at ( - 1 ). cards . push (
...[... node . children ]. map (( li ) => ({
title : li . firstElementChild . textContent ,
line : li . textContent . slice ( li . firstElementChild . textContent . length ),
}))
);
}
return out ;
});
const expected = CATALOG_GROUPS . map (( g ) => ({
title : g . title ,
cards : SKILL_CATALOG . filter (( e ) => e . group === g . id ). map (( e ) => ({ title : e . title + "." , line : " " + ( e . help || e . blurb ) })),
}));
assert . deepEqual ( drawnGroups , expected );
// Each card's title and line appear exactly once in the whole topic.
const text = await panel . evaluate (( n ) => n . textContent );
const titles = await panel . locator ( ".help-cards li > strong" ). allTextContents ();
for ( const e of SKILL_CATALOG ) {
assert . equal ( titles . filter (( x ) => x === e . title + "." ). length , 1 , ` ${ e . title } is listed once` );
assert . equal ( text . split ( e . help || e . blurb ). length - 1 , 1 , ` ${ e . title } 's line appears once` );
}
// Built once: a second open adds no second list.
await s . page . keyboard . press ( "Escape" );
await helpModal ( s ). waitFor ({ state : "hidden" });
await openHelp ( s );
assert . equal ( await panel . locator ( ".help-cards li" ). count (), SKILL_CATALOG . length );
});
2026-10-18 15:39:24 -07:00
// A newer release on record, so a console that boots now has an update to
// announce (the check reads this file for an hour instead of asking the
// network). The file is put back as the suite had it.
function aNewerReleaseExists ( t ) {
const file = path . join ( HOME , "update-check.json" );
const before = fs . readFileSync ( file , "utf8" );
fs . writeFileSync ( file , JSON . stringify ({ checkedAt : Date . now (), latest : "99.0.0" }));
t . after (() => fs . writeFileSync ( file , before ));
}
test ( "the update banner opens a modal with the exact update commands, and its dismissal is remembered for the session" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
aNewerReleaseExists ( t );
const s = await openSession ( await suite . browser (), { t , workflow : "dashboard" , payload : { agent : { status : "waiting" } }, project : tempProject () });
await toTheDashboard ( s );
const main = s . page . locator ( "#main" );
await main . getByRole ( "button" , { name : /UPDATE AVAILABLE · v99\.0\.0/ }). click ();
const modal = s . page . locator ( "#update-modal" );
await modal . waitFor ();
assert . match ( await textOf ( s . page . locator ( "#update-versions" )), /^Version v99\.0\.0 is out/ );
const releases = s . page . locator ( "#update-versions a" );
assert . equal ( await releases . getAttribute ( "href" ), RELEASES_URL );
assert . equal ( await releases . getAttribute ( "rel" ), "noopener noreferrer" );
assert . equal ( await textOf ( s . page . locator ( "#update-command code" )), "plan2code update" );
assert . equal (
await textOf ( s . page . locator ( "#update-fallback code" )),
"npx --allow-git=all git+https://github.com/jparkerweb/plan2code.git"
);
await s . page . locator ( "#update-done" ). click ();
await modal . waitFor ({ state : "hidden" });
// The × : gone now, remembered under this session's key, and still gone after a reload.
await main . getByRole ( "button" , { name : "Dismiss until next time" }). click ();
await main . getByRole ( "button" , { name : /UPDATE AVAILABLE/ }). waitFor ({ state : "hidden" });
assert . equal ( await s . page . evaluate (( k ) => sessionStorage . getItem ( k ), "p2c-update-dismissed:" + s . sid ), "99.0.0" );
await s . page . reload ({ waitUntil : "domcontentloaded" });
await drawn ( s . page );
await toTheDashboard ( s );
assert . equal ( await main . getByRole ( "button" , { name : /UPDATE AVAILABLE/ }). count (), 0 , "the banner came back after a reload" );
});
2026-10-25 12:46:52 -07:00
2026-11-10 10:19:33 -08:00
// Under the app Help's update line names both notices, says the command runs
// outside the app with a reopen after, and keeps Update skills for a mismatch.
test ( "under the app, Help's update line says to run the command outside the app and keeps Update skills for a mismatch" , async ( t ) => {
2026-10-25 12:46:52 -07:00
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "dashboard" ,
payload : { agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await toTheDashboard ( s );
await openHelp ( s );
await tabButton ( s , "dashboard" ). click ();
const text = s . page . locator ( "#help-update-text" );
await text . getByText ( "Update skills" , { exact : false }). waitFor ();
2026-11-10 10:19:33 -08:00
assert . equal ( await text . locator ( "code" ). textContent (), "plan2code update" );
await text . getByText ( "outside the app" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "/plan2code" , { exact : false }). count (), 0 , "no restart through /plan2code under the app" );
2026-10-25 12:46:52 -07:00
});
// Under the app, when the console server itself is gone, the live "About"
// line must not send the reader hunting for a link in a terminal: the app's
// own bar already notices and offers to reconnect it.
test ( "under the app, Help's live line about a gone console names the app's bar, not a terminal link" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
env : { PLAN2CODE_IN_APP : "1" },
clock : true ,
});
await stopServer ( s );
for ( let i = 0 ; i < 20 && ! ( await s . page . locator ( "#planny.is-gone" ). count ()); i ++ ) {
await s . page . clock . fastForward ( GONE_AFTER_MS );
await new Promise (( r ) => setTimeout ( r , 250 ));
}
await openHelp ( s );
// Help opens on "stuck" while gone (helpTabFor); the live line itself lives
// on "about", built the same regardless of which tab is first shown.
await tabButton ( s , "about" ). click ();
const live = s . page . locator ( "#about-live" );
await live . getByText ( "The app's own bar notices and offers to reconnect it" , { exact : false }). waitFor ();
assert . equal ( await live . getByText ( "link from the terminal" , { exact : false }). count (), 0 , "no terminal-link wording under the app" );
});
// Help's own "Running the next command" explainer (the Finishing topic) said
// "paste into the terminal... in a new conversation": wrong under the app,
// where it's the one terminal panel, not a separate conversation.
test ( "under the app, Help's Finishing topic says to paste into the terminal panel, not a new conversation" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "finishing" ). click ();
const text = s . page . locator ( "#help-finishing-command-text" );
await text . getByText ( "terminal panel below" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// The same topic's "Back to the dashboard" and "Continue here" explainers
// also described classic-only behavior the screens themselves no longer show
// under the app: a command to copy, and a new conversation to start fresh in.
test ( "under the app, Help's dashboard and Continue here explainers point at the app's own controls" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "finishing" ). click ();
const dash = s . page . locator ( "#help-finishing-dashboard-text" );
await dash . getByText ( "the app's own bar notices and offers to reconnect it" , { exact : false }). waitFor ();
assert . equal ( await dash . locator ( "code" ). count (), 0 , "no /plan2code command under the app" );
const cont = s . page . locator ( "#help-finishing-continue-text" );
await cont . getByText ( "press New Session at the top of the window" , { exact : false }). waitFor ();
assert . equal ( await cont . getByText ( "new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// The Welcome dialog's own onboarding tip gave the same classic-only advice.
test ( "under the app, the Welcome dialog's refresh tip names New Session, not a new conversation" , async ( t ) => {
savedLooks ( t , null );
const s = await openSession ( await suite . browser (), {
t ,
workflow : "dashboard" ,
payload : { agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await toTheDashboard ( s );
const welcome = s . page . locator ( "#welcome-modal" );
await welcome . waitFor ();
const text = s . page . locator ( "#welcome-refresh-text" );
await text . getByText ( "press New Session at the top of the window" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// The Troubleshooting tab's own "getting a new link" recovery flow is
// classic-only (it ends in a command that prints a fresh browser link);
// under the app, Reconnect the console in the bar already does this.
test ( "under the app, Help's Troubleshooting topic names Reconnect the console, not a new link to print" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "stuck" ). click ();
const ref = s . page . locator ( "#help-stuck-not-connected-ref" );
await ref . getByText ( "the app's own bar notices and offers to reconnect it" , { exact : false }). waitFor ();
await s . page . locator ( "#help-stuck-reconnect-title" ). getByText ( "Reconnecting" ). waitFor ();
const text = s . page . locator ( "#help-stuck-reconnect-text" );
await text . getByText ( "Reconnect the console" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "in the terminal" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
assert . equal ( await s . page . locator ( "#help-stuck-reconnect-command" ). isVisible (), false , "no command to copy under the app" );
// The "What you might see" symptom table has its own, separate "Not
// connected" row making the same classic-only claim.
const tableRow = s . page . locator ( "#help-stuck-table-reconnect-text" );
await tableRow . getByText ( "Reconnect the console" , { exact : false }). waitFor ();
assert . equal ( await tableRow . getByText ( "new link" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// The Ask tab's "carry away" prompt is meant to start a genuinely fresh task:
// under the app that means New Session first, then the terminal panel, not
// "a new conversation" that does not exist there.
test ( "under the app, Help's Ask topic says to press New Session and paste into the terminal panel, not a new conversation" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "ask" ). click ();
const text = s . page . locator ( "#help-ask-prompt-text" );
await text . getByText ( "Press New Session for a clean context, then paste it into the terminal panel" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// "Stopping early" also pointed to a terminal command "in a new conversation":
// matches ending.js's own renderStopping, which already says the terminal panel.
test ( "under the app, Help's Stopping early topic says to paste into the terminal panel, not a new conversation" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "finishing" ). click ();
const text = s . page . locator ( "#help-finishing-stop-text" );
await text . getByText ( "to paste into the terminal panel" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// The Planny-poses catalog's own "Done" entry also said "close the tab":
// there is no tab under the app, only the one window.
test ( "under the app, Planny's Done pose says to close the window, not the tab" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await openHelp ( s );
await tabButton ( s , "planny" ). click ();
const text = s . page . locator ( "#help-planny-done-text" );
await text . getByText ( "close the window" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "close the tab" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// Help's own description of the handoff Copy button named "a new conversation",
// the console's own wording for what New Session does under the app.
test ( "under the app, Help's dashboard topic calls the handoff copy button Copy for another session" , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "dashboard" ,
payload : { agent : { status : "waiting" } },
project : tempProject (),
env : { PLAN2CODE_IN_APP : "1" },
});
await toTheDashboard ( s );
await openHelp ( s );
await tabButton ( s , "dashboard" ). click ();
const text = s . page . locator ( "#help-handoff-copy-text" );
await text . getByText ( "Copy for another session" , { exact : false }). waitFor ();
assert . equal ( await text . getByText ( "Copy for a new conversation" , { exact : false }). count (), 0 , "no classic-mode wording under the app" );
});
// Every Help topic, as the reader sees it in each mode: the visible text of
// each panel in turn. A browser tab's wording never shows under the app, and
// the app's never shows in a browser, wherever in Help it sits.
async function visibleHelpText ( s ) {
await openHelp ( s );
const texts = {};
for ( const t of HELP_TABS ) {
await tabButton ( s , t . id ). click ();
texts [ t . id ] = await s . page . locator ( "#help-panel-" + t . id ). innerText ();
}
return texts ;
}
const BROWSER_ONLY = [ /browser tab/i , /this tab\b/i , /close the tab/i , /closed tab/i , /in your browser/i , /your terminal/i , /in a new conversation/i , /new link/i , /same link/i , /address bar/i , /terminal you started/i ];
const APP_ONLY = [ /terminal panel/i , /app's window/i , /app's own bar/i , /New Session/ ];
for ( const inApp of [ true , false ]) {
test ( `every Help topic reads right ${ inApp ? "under the app" : "in a browser" } ` , async ( t ) => {
savedLooks ( t , { welcomeSeen : true });
const s = await openSession ( await suite . browser (), {
t ,
workflow : "plan" ,
payload : { items : [{ id : "q1" , kind : "text" , title : "What to call it" , body : "A short name." }], agent : { status : "waiting" } },
project : tempProject (),
...( inApp ? { env : { PLAN2CODE_IN_APP : "1" } } : {}),
});
const texts = await visibleHelpText ( s );
const hits = [];
for ( const [ tab , text ] of Object . entries ( texts )) {
for ( const re of inApp ? BROWSER_ONLY : APP_ONLY ) {
const hit = text . match ( re );
if ( hit ) hits . push ( ` ${ tab } : ... ${ text . slice ( Math . max ( 0 , hit . index - 50 ), hit . index + 50 ). replace ( /\s+/g , " " ) } ...` );
}
}
assert . deepEqual ( hits , [], "wording from the other mode" );
// And each mode's own wording is really there, so the sweep is reading the panels.
const all = Object . values ( texts ). join ( " " );
assert . match ( all , inApp ? /terminal panel/ : /your terminal/ );
});
}