mirror of
https://github.com/jparkerweb/plan2code.git
synced 2026-11-16 04:45:33 -08:00
Explain stuck sessions in Help and add a Before you close this panel to finished screens
AI Assisted
This commit is contained in:
1 parent
3469a74cc1
commit
a3b117dafc
7 files changed
+386
-159
No files matched your search
Binary file not shown.
|
Before Width: | Height: | Size: 96 KiB After Width: | Height: | Size: 94 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 102 KiB After Width: | Height: | Size: 100 KiB |
@@ -1050,7 +1050,7 @@ test("help: every number the help quotes matches the code", () => {
|
||||
const panels = new Map(
|
||||
[...tpl.matchAll(/<section class="help-panel" data-tab="([^"]+)">([\s\S]*?)<\/section>/g)].map((m) => [m[1], m[2]])
|
||||
);
|
||||
const firstSeven = HELP_TABS.slice(0, 7).map((t) => panels.get(t.id)).join("\n");
|
||||
const firstEight = HELP_TABS.slice(0, 8).map((t) => panels.get(t.id)).join("\n");
|
||||
const used = [
|
||||
"closedTabMinutes",
|
||||
"maxLifeHours",
|
||||
@@ -1062,7 +1062,7 @@ test("help: every number the help quotes matches the code", () => {
|
||||
"maxUploadMb",
|
||||
"cleanupDays",
|
||||
];
|
||||
for (const key of used) assert.ok(firstSeven.includes(`data-fact="${key}"`), `tabs 1 to 7 quote ${key}`);
|
||||
for (const key of used) assert.ok(firstEight.includes(`data-fact="${key}"`), `tabs 1 to 8 quote ${key}`);
|
||||
});
|
||||
|
||||
/* ---------------------------------------------------------- image uploads */
|
||||
@@ -7048,3 +7048,56 @@ test("the Changelog card comes just before Git commit and is always on", () => {
|
||||
assert.equal(cardAvailability(entry, scan, null).on, true);
|
||||
}
|
||||
});
|
||||
|
||||
/* ------------------------------------------- getting started: stuck help and the finished screen */
|
||||
|
||||
const EM = String.fromCharCode(0x2014);
|
||||
const publicSource = (name) => fs.readFileSync(path.join(ROOT, "src", "web-console", "public", name), "utf8");
|
||||
|
||||
test("help: the stuck tab is second, with a callout and four symptom rows before the diagram", () => {
|
||||
assert.equal(HELP_TABS[0].id, "about");
|
||||
assert.equal(HELP_TABS[1].id, "stuck");
|
||||
const tpl = helpTemplate();
|
||||
const panel = tpl.match(/<section class="help-panel" data-tab="stuck">([\s\S]*?)<\/section>/)[1];
|
||||
assert.match(panel, /<div class="help-callout" role="note">/);
|
||||
assert.match(panel, /Check this first/);
|
||||
assert.match(panel, /look at your terminal/);
|
||||
assert.equal((panel.match(/class="help-row"/g) || []).length, 4, "four symptom rows");
|
||||
for (const part of ["You see", "Likely cause", "Do this"]) {
|
||||
assert.equal((panel.match(new RegExp(`<dt>${part}</dt>`, "g")) || []).length, 4, `each row has "${part}"`);
|
||||
}
|
||||
assert.ok(panel.indexOf("help-rows") < panel.indexOf("help-figure"), "the rows come before the diagram");
|
||||
assert.match(panel, /<svg class="help-callout-icon"[^>]*aria-hidden="true"/, "the icon is decoration");
|
||||
});
|
||||
|
||||
test("status line: the quiet and Not running lines offer What to check, opening Help on the stuck tab", () => {
|
||||
const app = publicSource("app.js");
|
||||
assert.match(app, /help\.textContent = "What to check"/);
|
||||
assert.match(app, /openHelpOn\("stuck"\)/);
|
||||
// Exactly the three lines that carry it: the approval hint, the stale line and the Not running line.
|
||||
const render = app.slice(app.indexOf("function renderStatus()"), app.indexOf("/* ---------------------------------------------------------------- brief */"));
|
||||
assert.match(render, /Boolean\(hint\)/);
|
||||
assert.equal((render.match(/^\s+true\n\s+\);/gm) || []).length, 2, "the stale and Not running lines pass check");
|
||||
});
|
||||
|
||||
test("finished screen: every shape shows Before you close this, with three rows", () => {
|
||||
const app = publicSource("app.js");
|
||||
const handoff = app.slice(app.indexOf("function renderHandoff("));
|
||||
assert.match(handoff.slice(0, handoff.indexOf("\n}\n")), /card\.appendChild\(renderCloseGuide\(shape\)\)/);
|
||||
const guide = app.slice(app.indexOf("function renderCloseGuide("), app.indexOf("function renderHandoff("));
|
||||
for (const label of ["Safe to close", "Start fresh", "Carry on", "Before you close this"]) {
|
||||
assert.ok(guide.includes(label), `the guide says "${label}"`);
|
||||
}
|
||||
assert.match(guide, /shape === "paused"/, "a pause changes the Start fresh sentence");
|
||||
assert.match(guide, /resume command/);
|
||||
});
|
||||
|
||||
test("getting started: the new help, status and finished-screen strings carry no em dash", () => {
|
||||
const app = publicSource("app.js");
|
||||
const guide = app.slice(app.indexOf("const GUIDE_ICONS"), app.indexOf("function renderHandoff("));
|
||||
assert.ok(!guide.includes(EM), "the close guide has no em dash");
|
||||
const tpl = helpTemplate();
|
||||
const stuck = tpl.match(/<section class="help-panel" data-tab="stuck">([\s\S]*?)<\/section>/)[1];
|
||||
const fresh = stuck.slice(0, stuck.indexOf("<h4>Not running, or not connected?</h4>"));
|
||||
assert.ok(!fresh.includes(EM), "the callout and rows have no em dash");
|
||||
});
|
||||
@@ -1376,6 +1376,26 @@ h1 {
|
||||
.presets { margin-top: 12px; gap: 8px; }
|
||||
.presets-label { font-size: 12.5px; color: var(--ink-3); }
|
||||
|
||||
/* "Before you close this": three rows on every finished screen. The icon sits
|
||||
in a coloured circle and the label says the same thing, so no meaning rests
|
||||
on colour alone. */
|
||||
.handoff-guide {
|
||||
margin: 20px 0 0; padding: 14px 16px;
|
||||
background: var(--panel-2); border: 1px solid var(--rule-2); border-radius: var(--radius);
|
||||
}
|
||||
.handoff-guide-title { margin: 0 0 10px; font: 600 15px/1.3 var(--serif); color: var(--ink); }
|
||||
.handoff-guide-rows { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 10px; }
|
||||
.handoff-guide-row { display: flex; align-items: flex-start; gap: 12px; font-size: 14px; color: var(--ink-2); }
|
||||
.handoff-guide-text { min-width: 0; overflow-wrap: anywhere; }
|
||||
.handoff-guide-label { color: var(--ink); }
|
||||
.handoff-guide-icon {
|
||||
flex: none; display: inline-flex; align-items: center; justify-content: center;
|
||||
width: 28px; height: 28px; border-radius: 50%; border: 1.5px solid currentColor;
|
||||
}
|
||||
.handoff-guide-icon svg { fill: none; stroke: currentColor; stroke-width: 2; stroke-linecap: round; stroke-linejoin: round; }
|
||||
.handoff-guide-icon.is-safe { color: var(--ok); background: var(--ok-soft); }
|
||||
.handoff-guide-icon.is-fresh { color: var(--accent-ink); background: var(--accent); border-color: var(--accent); }
|
||||
.handoff-guide-icon.is-carry { color: var(--accent); background: var(--accent-soft); }
|
||||
.handoff-close { margin: 16px 0 0; color: var(--ink-2); }
|
||||
.handoff-tools { margin-top: 16px; }
|
||||
.handoff-unsent {
|
||||
@@ -2361,6 +2381,26 @@ a.icon-btn { box-sizing: border-box; text-decoration: none; }
|
||||
padding: 1px 5px;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
/* Help, "When something looks stuck": a calm callout and a symptom / cause / action list. */
|
||||
.help-panel .help-callout {
|
||||
display: flex; align-items: flex-start; gap: 12px;
|
||||
margin: 0 0 16px; padding: 12px 14px;
|
||||
background: var(--stage-soft); border: 1px solid var(--stage); border-left-width: 4px; border-radius: var(--radius);
|
||||
}
|
||||
.help-callout-icon { flex: none; width: 22px; height: 22px; margin-top: 1px; fill: none; stroke: var(--stage); stroke-width: 1.8; stroke-linecap: round; stroke-linejoin: round; }
|
||||
.help-panel .help-callout-label { display: block; margin-bottom: 2px; font-size: 14px; color: var(--ink); }
|
||||
.help-panel .help-callout p { margin: 0; color: var(--ink); }
|
||||
.help-panel ol.help-rows { list-style: none; margin: 0 0 12px; padding: 0; }
|
||||
.help-row { margin: 0 0 8px; padding: 10px 12px; background: var(--panel-2); border: 1px solid var(--rule); border-radius: var(--radius); }
|
||||
.help-panel .help-row:last-child { margin-bottom: 0; }
|
||||
.help-row dl { display: grid; grid-template-columns: max-content 1fr; gap: 3px 12px; margin: 0; }
|
||||
.help-row dt { font-size: 12px; font-weight: 700; letter-spacing: 0.02em; text-transform: uppercase; color: var(--ink-2); padding-top: 1px; }
|
||||
.help-row dd { margin: 0; font-size: 13.5px; color: var(--ink); min-width: 0; overflow-wrap: anywhere; }
|
||||
@media (max-width: 520px) {
|
||||
.help-row dl { grid-template-columns: 1fr; gap: 0; }
|
||||
.help-row dt { margin-top: 6px; }
|
||||
.help-row dt:first-child { margin-top: 0; }
|
||||
}
|
||||
.help-panel .handoff-command { margin: 0 0 12px; }
|
||||
.help-panel .handoff-command:last-child { margin-bottom: 0; }
|
||||
.help-panel .handoff-code {
|
||||
@@ -3567,3 +3607,12 @@ a.icon-btn { box-sizing: border-box; text-decoration: none; }
|
||||
color: var(--accent);
|
||||
font-weight: 700;
|
||||
}
|
||||
|
||||
/* "What to check", beside the quiet and Not running lines. A link in a button's clothes. */
|
||||
.status-help {
|
||||
font: inherit; font-size: 0.92em; font-weight: 600;
|
||||
color: var(--accent); background: none; border: 0; padding: 0 2px;
|
||||
text-decoration: underline; text-underline-offset: 2px; cursor: pointer;
|
||||
}
|
||||
.status-help:hover { text-decoration-thickness: 2px; }
|
||||
.status-help:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; border-radius: 3px; }
|
||||
@@ -1637,23 +1637,32 @@ function renderStatus() {
|
||||
// end right now, and it flies too: the ring and the stars mean the same
|
||||
// thing. Never on the stale or adrift lines: a turning ring beside
|
||||
// "has not checked in" would contradict the sentence it sits next to.
|
||||
const say = (mood, line, count, spin) => {
|
||||
// `check` adds a "What to check" button that opens Help on the stuck tab.
|
||||
const say = (mood, line, count, spin, check) => {
|
||||
if (mood !== moodNow) {
|
||||
moodNow = mood;
|
||||
moodVar = Math.floor(Math.random() * MOOD_VARIANTS[mood]);
|
||||
}
|
||||
bot.setAttribute("class", `planny is-${mood} v${moodVar}`);
|
||||
if (text.dataset.line !== line) {
|
||||
text.dataset.line = line;
|
||||
text.replaceChildren(
|
||||
...line.split(/\*\*(.+?)\*\*/).map((part, i) => {
|
||||
if (i % 2 === 0) return document.createTextNode(part);
|
||||
const key = document.createElement("strong");
|
||||
key.className = "agent-key";
|
||||
key.textContent = part;
|
||||
return key;
|
||||
})
|
||||
);
|
||||
const shown = check ? `${line}|check` : line;
|
||||
if (text.dataset.line !== shown) {
|
||||
text.dataset.line = shown;
|
||||
const parts = line.split(/\*\*(.+?)\*\*/).map((part, i) => {
|
||||
if (i % 2 === 0) return document.createTextNode(part);
|
||||
const key = document.createElement("strong");
|
||||
key.className = "agent-key";
|
||||
key.textContent = part;
|
||||
return key;
|
||||
});
|
||||
if (check) {
|
||||
const help = document.createElement("button");
|
||||
help.type = "button";
|
||||
help.className = "status-help";
|
||||
help.textContent = "What to check";
|
||||
help.addEventListener("click", () => openHelpOn("stuck"));
|
||||
parts.push(document.createTextNode(" "), help);
|
||||
}
|
||||
text.replaceChildren(...parts);
|
||||
}
|
||||
tick.textContent = count || "";
|
||||
$("agent-spin").hidden = !spin;
|
||||
@@ -1710,13 +1719,16 @@ function renderStatus() {
|
||||
if (agentStale()) {
|
||||
return say(
|
||||
"work",
|
||||
"Still working on it. Longer tasks can go a few minutes between updates. Your answers are saved. If it stays quiet for a long while, check your terminal (it may be waiting on a permission approval)."
|
||||
"Still working on it. Longer tasks can go a few minutes between updates. Your answers are saved. If it stays quiet for a long while, check your terminal (it may be waiting on a permission approval).",
|
||||
"",
|
||||
false,
|
||||
true
|
||||
);
|
||||
}
|
||||
// Same clock as agentStale(), so the soft line at 30 s hands over to the
|
||||
// stale message at two minutes on one timeline.
|
||||
const hint = agentLastSeen ? approvalHint(S.agent, Date.now() - Date.parse(agentLastSeen)) : "";
|
||||
return say("work", hint || activity() || "Plan2Code is thinking…", fmtMs(workingMs()), true);
|
||||
return say("work", hint || activity() || "Plan2Code is thinking…", fmtMs(workingMs()), true, Boolean(hint));
|
||||
}
|
||||
// Between pressing Send and the agent picking it up, the agent's own status
|
||||
// is still "waiting" because it has not started yet. Reading that as "your
|
||||
@@ -1729,7 +1741,10 @@ function renderStatus() {
|
||||
"adrift",
|
||||
stranded()
|
||||
? "Plan2Code is not running. Your answers are saved and waiting for it. If the terminal is idle, type **continue** there and it will pick them up; it may also be waiting for your permission approval."
|
||||
: "Plan2Code is not running right now. Anything you answer here is saved. If the terminal is idle, type **continue** there to wake it; it may also be waiting for your permission approval."
|
||||
: "Plan2Code is not running right now. Anything you answer here is saved. If the terminal is idle, type **continue** there to wake it; it may also be waiting for your permission approval.",
|
||||
"",
|
||||
false,
|
||||
true
|
||||
);
|
||||
}
|
||||
|
||||
@@ -2312,6 +2327,69 @@ function paintMain(main) {
|
||||
// in prose and useless for the single action a screen exists to offer. A
|
||||
// finish with nothing left to run skips the last two beats: it gets a quiet
|
||||
// pointer at the dashboard instead of a Next step block.
|
||||
// "Before you close this": the three things someone looking at a finished
|
||||
// screen wonders. Every finish shape gets it; a pause says where the place is
|
||||
// kept, and a session with nothing left to run points at the dashboard alone.
|
||||
const GUIDE_ICONS = {
|
||||
safe: ["M5 12.5 10 17.5 19 7"],
|
||||
fresh: ["M19.5 12a7.5 7.5 0 1 1-2.4-5.5", "M19.5 4v4.5H15"],
|
||||
carry: ["M5 12h13", "M13 6.5 18.5 12 13 17.5"],
|
||||
};
|
||||
|
||||
function guideIcon(kind) {
|
||||
const wrap = el("span", `handoff-guide-icon is-${kind}`);
|
||||
wrap.setAttribute("aria-hidden", "true");
|
||||
const svg = document.createElementNS(SVG_NS, "svg");
|
||||
svg.setAttribute("viewBox", "0 0 24 24");
|
||||
svg.setAttribute("width", "16");
|
||||
svg.setAttribute("height", "16");
|
||||
for (const d of GUIDE_ICONS[kind]) {
|
||||
const path = document.createElementNS(SVG_NS, "path");
|
||||
path.setAttribute("d", d);
|
||||
svg.appendChild(path);
|
||||
}
|
||||
wrap.appendChild(svg);
|
||||
return wrap;
|
||||
}
|
||||
|
||||
function renderCloseGuide(shape) {
|
||||
const panel = el("section", "handoff-guide");
|
||||
panel.setAttribute("aria-labelledby", "handoff-guide-title");
|
||||
const title = el("h3", "handoff-guide-title", "Before you close this");
|
||||
title.id = "handoff-guide-title";
|
||||
panel.appendChild(title);
|
||||
const rows = [
|
||||
["safe", "Safe to close", "This tab is only a window. Everything is saved on disk, and nothing here needs you."],
|
||||
[
|
||||
"fresh",
|
||||
"Start fresh",
|
||||
shape === "paused"
|
||||
? "Restart your agent window, or close the old session and start a new one. Your saved place is picked up by the resume command above."
|
||||
: "Restart your agent window, or close the old session and start a new one. A new session starts from clean context. This one is full of this step's instructions, so continuing in it is slower and can confuse the next step.",
|
||||
],
|
||||
[
|
||||
"carry",
|
||||
"Carry on",
|
||||
shape === "all-done"
|
||||
? `In the new session, start from the dashboard with \`${DASHBOARD_COMMAND}\`.`
|
||||
: `Paste the command above in the new session, or start from the dashboard with \`${DASHBOARD_COMMAND}\`.`,
|
||||
],
|
||||
];
|
||||
const list = el("ul", "handoff-guide-rows");
|
||||
for (const [kind, label, text] of rows) {
|
||||
const row = el("li", "handoff-guide-row");
|
||||
row.appendChild(guideIcon(kind));
|
||||
const body = el("div", "handoff-guide-text");
|
||||
body.appendChild(el("strong", "handoff-guide-label", label));
|
||||
body.appendChild(document.createTextNode(" "));
|
||||
body.appendChild(textWithCode("span", "handoff-guide-line", text));
|
||||
row.appendChild(body);
|
||||
list.appendChild(row);
|
||||
}
|
||||
panel.appendChild(list);
|
||||
return panel;
|
||||
}
|
||||
|
||||
function renderHandoff(fin) {
|
||||
const card = el("article", "card handoff");
|
||||
card.appendChild(el("p", "card-kicker", "Session ended"));
|
||||
@@ -2402,13 +2480,15 @@ function renderHandoff(fin) {
|
||||
}
|
||||
}
|
||||
|
||||
card.appendChild(renderCloseGuide(shape));
|
||||
|
||||
card.appendChild(
|
||||
el(
|
||||
"p",
|
||||
"handoff-close",
|
||||
reviewPending() === "open"
|
||||
? "The review is optional. Skip it and you can close this tab: nothing else here needs you."
|
||||
: "Then you can close this tab. Nothing here needs you any more."
|
||||
? "The review is optional. Skip it and nothing else here needs you."
|
||||
: "That is everything on this page."
|
||||
)
|
||||
);
|
||||
|
||||
|
||||
@@ -9,6 +9,7 @@ const tab = (id, label, diagram) => Object.freeze({ id, label, diagram });
|
||||
|
||||
export const HELP_TABS = Object.freeze([
|
||||
tab("about", "What this page is", true),
|
||||
tab("stuck", "When something looks stuck", true),
|
||||
tab("around", "Finding your way around", true),
|
||||
tab("workspace", "Your workspace", false),
|
||||
tab("planny", "Reading Planny", true),
|
||||
@@ -22,7 +23,6 @@ export const HELP_TABS = Object.freeze([
|
||||
tab("subagents", "Helpers (subagents)", false),
|
||||
tab("ask", "Ask a quick question", false),
|
||||
tab("finishing", "Stopping and finishing", false),
|
||||
tab("stuck", "When something looks stuck", true),
|
||||
tab("prefs", "Keyboard and preferences", false),
|
||||
tab("privacy", "Privacy and where things are saved", false),
|
||||
]);
|
||||
|
||||
+184
-139
@@ -602,6 +602,10 @@
|
||||
<path d="M12 11v6" />
|
||||
<path d="M12 7.5v.5" />
|
||||
</symbol>
|
||||
<symbol id="hi-stuck" viewBox="0 0 24 24" fill="none">
|
||||
<path d="M12 4l9 16H3z" />
|
||||
<path d="M12 10v4.5M12 17v.5" />
|
||||
</symbol>
|
||||
<symbol id="hi-around" viewBox="0 0 24 24" fill="none">
|
||||
<circle cx="12" cy="12" r="9" />
|
||||
<path d="M15.5 8.5l-2 5-5 2 2-5z" />
|
||||
@@ -660,10 +664,6 @@
|
||||
<path d="M6 21V4" />
|
||||
<path d="M6 4h11l-2 4 2 4H6" />
|
||||
</symbol>
|
||||
<symbol id="hi-stuck" viewBox="0 0 24 24" fill="none">
|
||||
<path d="M12 4l9 16H3z" />
|
||||
<path d="M12 10v4.5M12 17v.5" />
|
||||
</symbol>
|
||||
<symbol id="hi-prefs" viewBox="0 0 24 24" fill="none">
|
||||
<path d="M4 7h16M4 12h16M4 17h16" />
|
||||
<circle cx="9" cy="7" r="1.8" />
|
||||
@@ -757,7 +757,174 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 2: Finding your way around -->
|
||||
<!-- Tab 2: When something looks stuck -->
|
||||
<section class="help-panel" data-tab="stuck">
|
||||
<h3>When something looks stuck</h3>
|
||||
<p class="help-lead">
|
||||
This page and Plan2Code in your terminal are two programs, and either
|
||||
can stop without the other. Nothing you have typed is lost either way.
|
||||
</p>
|
||||
<div class="help-callout" role="note">
|
||||
<svg class="help-callout-icon" viewBox="0 0 24 24" aria-hidden="true">
|
||||
<path d="M12 3.5 22 20.5H2Z" />
|
||||
<path d="M12 10v5" />
|
||||
<path d="M12 17.8v.4" />
|
||||
</svg>
|
||||
<div>
|
||||
<strong class="help-callout-label">Check this first</strong>
|
||||
<p>
|
||||
If nothing seems to be happening, look at your terminal. Plan2Code
|
||||
often stops there to ask your permission, and this page cannot see it.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
<h4>What you might see</h4>
|
||||
<ol class="help-rows">
|
||||
<li class="help-row">
|
||||
<dl>
|
||||
<dt>You see</dt><dd>The line beside Planny stays quiet for a minute or two while it is working.</dd>
|
||||
<dt>Likely cause</dt><dd>A permission prompt is waiting in your terminal.</dd>
|
||||
<dt>Do this</dt><dd>Switch to the terminal and answer it.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li class="help-row">
|
||||
<dl>
|
||||
<dt>You see</dt><dd><strong>Not running</strong> (Planny grey and still).</dd>
|
||||
<dt>Likely cause</dt><dd>Plan2Code has not checked in for a few minutes.</dd>
|
||||
<dt>Do this</dt><dd>Look at the terminal. If it is idle, type <code>continue</code> there.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li class="help-row">
|
||||
<dl>
|
||||
<dt>You see</dt><dd><strong>Not connected</strong> (Planny faded, his star shut).</dd>
|
||||
<dt>Likely cause</dt><dd>The program behind this page shut itself down.</dd>
|
||||
<dt>Do this</dt><dd>Ask Plan2Code to resume the session, and use the new link.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
<li class="help-row">
|
||||
<dl>
|
||||
<dt>You see</dt><dd>Nothing on the page changes after you press Send.</dd>
|
||||
<dt>Likely cause</dt><dd>The agent is busy, or has finished its turn.</dd>
|
||||
<dt>Do this</dt><dd>Your answer is saved. Check the terminal.</dd>
|
||||
</dl>
|
||||
</li>
|
||||
</ol>
|
||||
<figure class="help-figure" data-figure="stuck">
|
||||
<svg class="help-diagram" viewBox="0 0 560 262" role="img" aria-labelledby="hd-stuck-title hd-stuck-desc">
|
||||
<title id="hd-stuck-title">What to check when something looks stuck</title>
|
||||
<desc id="hd-stuck-desc">
|
||||
A decision flow. First: does Planny say Not connected? If yes, run
|
||||
the command again and use the new link. If no: does he say Not
|
||||
running? If yes, look at the terminal, which may be waiting for
|
||||
your permission, finished or errored. Either way, and in every
|
||||
other case, answering anyway is safe, because what you send is
|
||||
held until Plan2Code collects it.
|
||||
</desc>
|
||||
<defs>
|
||||
<marker id="hd-stuck-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="5" markerHeight="5" orient="auto-start-reverse">
|
||||
<path class="hd-arrow" d="M0 0 L8 4 L0 8 z" />
|
||||
</marker>
|
||||
</defs>
|
||||
<path class="hd-box" d="M20 50 L110 16 L200 50 L110 84 Z" />
|
||||
<text class="hd-label" x="110" y="46" text-anchor="middle">Says Not</text>
|
||||
<text class="hd-label" x="110" y="63" text-anchor="middle">connected?</text>
|
||||
<rect class="hd-box" x="260" y="26" width="284" height="48" rx="8" />
|
||||
<text class="hd-label" x="402" y="46" text-anchor="middle">Run the command again,</text>
|
||||
<text class="hd-label" x="402" y="63" text-anchor="middle">use the new link</text>
|
||||
<path class="hd-line" d="M202 50 H256" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="228" y="43" text-anchor="middle">yes</text>
|
||||
<path class="hd-line" d="M110 86 V112" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="118" y="103">no</text>
|
||||
<path class="hd-box" d="M20 150 L110 116 L200 150 L110 184 Z" />
|
||||
<text class="hd-label" x="110" y="146" text-anchor="middle">Says Not</text>
|
||||
<text class="hd-label" x="110" y="163" text-anchor="middle">running?</text>
|
||||
<rect class="hd-box" x="260" y="120" width="284" height="60" rx="8" />
|
||||
<text class="hd-label" x="402" y="144" text-anchor="middle">Look at the terminal: waiting</text>
|
||||
<text class="hd-label" x="402" y="162" text-anchor="middle">for permission, finished, errored?</text>
|
||||
<path class="hd-line" d="M202 150 H256" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="228" y="143" text-anchor="middle">yes</text>
|
||||
<path class="hd-line" d="M110 186 V206" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="118" y="200">no</text>
|
||||
<path class="hd-line" d="M402 182 V206" marker-end="url(#hd-stuck-arrow)" />
|
||||
<path class="hd-line" d="M546 50 H554 V231 H474" marker-end="url(#hd-stuck-arrow)" />
|
||||
<rect class="hd-accent" x="90" y="210" width="380" height="44" rx="8" />
|
||||
<text class="hd-label hd-accent" x="280" y="229" text-anchor="middle">Answering anyway is safe:</text>
|
||||
<text class="hd-label" x="280" y="246" text-anchor="middle">what you send is held until it is collected</text>
|
||||
<path class="hd-flow" d="M202 50 H256 M546 50 H554 V231 H474" />
|
||||
</svg>
|
||||
<figcaption>Whatever you find, nothing you have typed is lost.</figcaption>
|
||||
</figure>
|
||||
<h4>Not running, or not connected?</h4>
|
||||
<ul>
|
||||
<li>
|
||||
<strong>Not running</strong> (Planny grey and still): this page is
|
||||
fine, but Plan2Code in the terminal has not checked in for
|
||||
<span data-fact="adriftMinutes">3</span> minutes. It may have finished
|
||||
its turn, hit an error, or be waiting on you there.
|
||||
</li>
|
||||
<li>
|
||||
<strong>Not connected</strong> (Planny faded, arms hanging, his star shut in red):
|
||||
this page cannot reach its own program, after
|
||||
<span data-fact="goneSeconds">8</span> seconds without contact.
|
||||
Usually it has shut itself down; see "Getting a new link" below.
|
||||
</li>
|
||||
</ul>
|
||||
<p>"Reading Planny" shows every mood side by side.</p>
|
||||
<h4>It may be waiting for you in the terminal</h4>
|
||||
<p>
|
||||
Plan2Code sometimes stops in the terminal to ask your permission
|
||||
before it runs a command or changes a file, and this page cannot see
|
||||
that. After about 30 seconds of silence while it is working, the line
|
||||
beside Planny asks "Still working, or waiting on an approval in your
|
||||
terminal?" Have a look at the terminal: answering there sets it going
|
||||
again.
|
||||
</p>
|
||||
<p>
|
||||
If it stays quiet a couple of minutes longer, the line changes to
|
||||
"Still working on it. Longer tasks can go a few minutes between
|
||||
updates", with Planny still
|
||||
in his working pose. It may be busy, or still waiting on you in the
|
||||
terminal; the terminal is where to look. A build that said a task may
|
||||
take longer gets that long before the line changes.
|
||||
</p>
|
||||
<p>
|
||||
Hands-off modes, such as <code>auto</code> mode in Claude Code or
|
||||
<code>smart</code> mode in Devin, cut down on those stops, though some
|
||||
may still need you.
|
||||
</p>
|
||||
<h4>Answering anyway</h4>
|
||||
<p>
|
||||
You can keep answering and press Send while Plan2Code is not running.
|
||||
What you send is written to disk and held until something collects it,
|
||||
so starting Plan2Code again picks it up where you left off.
|
||||
</p>
|
||||
<h4>Getting a new link</h4>
|
||||
<p>The program behind this page shuts itself down:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<span data-fact="closedTabMinutes">2</span> minutes after the last tab
|
||||
showing it closes,
|
||||
</li>
|
||||
<li>
|
||||
after <span data-fact="idleMinutes">30</span> minutes without hearing
|
||||
from anyone, or
|
||||
</li>
|
||||
<li>
|
||||
after <span data-fact="maxLifeHours">4</span> hours, whatever is
|
||||
happening.
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
To get it back, ask Plan2Code in the terminal to resume the session,
|
||||
or run the step's command again, and use the new link it gives you.
|
||||
Everything you typed, sent or not, is still there.
|
||||
</p>
|
||||
<div class="handoff-command" data-copy>
|
||||
<code class="handoff-code">resume the session and print the web console address here</code>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Tab 3: Finding your way around -->
|
||||
<section class="help-panel" data-tab="around">
|
||||
<h3>Finding your way around</h3>
|
||||
<p class="help-lead">
|
||||
@@ -891,7 +1058,7 @@
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<!-- Tab 3: Your workspace -->
|
||||
<!-- Tab 4: Your workspace -->
|
||||
<section class="help-panel" data-tab="workspace">
|
||||
<h3>Your workspace</h3>
|
||||
<p class="help-lead">
|
||||
@@ -982,7 +1149,7 @@
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<!-- Tab 4: Reading Planny -->
|
||||
<!-- Tab 5: Reading Planny -->
|
||||
<section class="help-panel" data-tab="planny">
|
||||
<h3>Reading Planny</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1030,7 +1197,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 5: Answering questions -->
|
||||
<!-- Tab 6: Answering questions -->
|
||||
<section class="help-panel" data-tab="answering">
|
||||
<h3>Answering questions</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1099,7 +1266,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 6: Sending and what happens next -->
|
||||
<!-- Tab 7: Sending and what happens next -->
|
||||
<section class="help-panel" data-tab="sending">
|
||||
<h3>Sending and what happens next</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1185,7 +1352,7 @@
|
||||
</ol>
|
||||
</section>
|
||||
|
||||
<!-- Tab 7: Notes and attachments -->
|
||||
<!-- Tab 8: Notes and attachments -->
|
||||
<section class="help-panel" data-tab="notes">
|
||||
<h3>Notes and attachments</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1253,7 +1420,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 8: Documents and printing -->
|
||||
<!-- Tab 9: Documents and printing -->
|
||||
<section class="help-panel" data-tab="docs">
|
||||
<h3>Documents and printing</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1312,7 +1479,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 9: The dashboard -->
|
||||
<!-- Tab 10: The dashboard -->
|
||||
<section class="help-panel" data-tab="dashboard">
|
||||
<h3>The dashboard</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1435,7 +1602,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 10: Session meter -->
|
||||
<!-- Tab 11: Session meter -->
|
||||
<section class="help-panel" data-tab="meter">
|
||||
<h3>Session meter</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1483,7 +1650,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 11: Watching a build -->
|
||||
<!-- Tab 12: Watching a build -->
|
||||
<section class="help-panel" data-tab="build">
|
||||
<h3>Watching a build</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1551,7 +1718,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 12: Helpers (subagents) -->
|
||||
<!-- Tab 13: Helpers (subagents) -->
|
||||
<section class="help-panel" data-tab="subagents">
|
||||
<h3>Helpers (subagents)</h3>
|
||||
<p>
|
||||
@@ -1606,7 +1773,7 @@
|
||||
</ul>
|
||||
</section>
|
||||
|
||||
<!-- Tab 13: Ask a quick question -->
|
||||
<!-- Tab 14: Ask a quick question -->
|
||||
<section class="help-panel" data-tab="ask">
|
||||
<h3>Ask a quick question</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1697,7 +1864,7 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 14: Stopping and finishing -->
|
||||
<!-- Tab 15: Stopping and finishing -->
|
||||
<section class="help-panel" data-tab="finishing">
|
||||
<h3>Stopping and finishing</h3>
|
||||
<p class="help-lead">
|
||||
@@ -1779,128 +1946,6 @@
|
||||
</p>
|
||||
</section>
|
||||
|
||||
<!-- Tab 15: When something looks stuck -->
|
||||
<section class="help-panel" data-tab="stuck">
|
||||
<h3>When something looks stuck</h3>
|
||||
<p class="help-lead">
|
||||
This page and Plan2Code in your terminal are two programs, and either
|
||||
can stop without the other. Nothing you have typed is lost either way.
|
||||
</p>
|
||||
<figure class="help-figure" data-figure="stuck">
|
||||
<svg class="help-diagram" viewBox="0 0 560 262" role="img" aria-labelledby="hd-stuck-title hd-stuck-desc">
|
||||
<title id="hd-stuck-title">What to check when something looks stuck</title>
|
||||
<desc id="hd-stuck-desc">
|
||||
A decision flow. First: does Planny say Not connected? If yes, run
|
||||
the command again and use the new link. If no: does he say Not
|
||||
running? If yes, look at the terminal, which may be waiting for
|
||||
your permission, finished or errored. Either way, and in every
|
||||
other case, answering anyway is safe, because what you send is
|
||||
held until Plan2Code collects it.
|
||||
</desc>
|
||||
<defs>
|
||||
<marker id="hd-stuck-arrow" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="5" markerHeight="5" orient="auto-start-reverse">
|
||||
<path class="hd-arrow" d="M0 0 L8 4 L0 8 z" />
|
||||
</marker>
|
||||
</defs>
|
||||
<path class="hd-box" d="M20 50 L110 16 L200 50 L110 84 Z" />
|
||||
<text class="hd-label" x="110" y="46" text-anchor="middle">Says Not</text>
|
||||
<text class="hd-label" x="110" y="63" text-anchor="middle">connected?</text>
|
||||
<rect class="hd-box" x="260" y="26" width="284" height="48" rx="8" />
|
||||
<text class="hd-label" x="402" y="46" text-anchor="middle">Run the command again,</text>
|
||||
<text class="hd-label" x="402" y="63" text-anchor="middle">use the new link</text>
|
||||
<path class="hd-line" d="M202 50 H256" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="228" y="43" text-anchor="middle">yes</text>
|
||||
<path class="hd-line" d="M110 86 V112" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="118" y="103">no</text>
|
||||
<path class="hd-box" d="M20 150 L110 116 L200 150 L110 184 Z" />
|
||||
<text class="hd-label" x="110" y="146" text-anchor="middle">Says Not</text>
|
||||
<text class="hd-label" x="110" y="163" text-anchor="middle">running?</text>
|
||||
<rect class="hd-box" x="260" y="120" width="284" height="60" rx="8" />
|
||||
<text class="hd-label" x="402" y="144" text-anchor="middle">Look at the terminal: waiting</text>
|
||||
<text class="hd-label" x="402" y="162" text-anchor="middle">for permission, finished, errored?</text>
|
||||
<path class="hd-line" d="M202 150 H256" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="228" y="143" text-anchor="middle">yes</text>
|
||||
<path class="hd-line" d="M110 186 V206" marker-end="url(#hd-stuck-arrow)" />
|
||||
<text class="hd-label small" x="118" y="200">no</text>
|
||||
<path class="hd-line" d="M402 182 V206" marker-end="url(#hd-stuck-arrow)" />
|
||||
<path class="hd-line" d="M546 50 H554 V231 H474" marker-end="url(#hd-stuck-arrow)" />
|
||||
<rect class="hd-accent" x="90" y="210" width="380" height="44" rx="8" />
|
||||
<text class="hd-label hd-accent" x="280" y="229" text-anchor="middle">Answering anyway is safe:</text>
|
||||
<text class="hd-label" x="280" y="246" text-anchor="middle">what you send is held until it is collected</text>
|
||||
<path class="hd-flow" d="M202 50 H256 M546 50 H554 V231 H474" />
|
||||
</svg>
|
||||
<figcaption>Whatever you find, nothing you have typed is lost.</figcaption>
|
||||
</figure>
|
||||
<h4>Not running, or not connected?</h4>
|
||||
<ul>
|
||||
<li>
|
||||
<strong>Not running</strong> (Planny grey and still): this page is
|
||||
fine, but Plan2Code in the terminal has not checked in for
|
||||
<span data-fact="adriftMinutes">3</span> minutes. It may have finished
|
||||
its turn, hit an error, or be waiting on you there.
|
||||
</li>
|
||||
<li>
|
||||
<strong>Not connected</strong> (Planny faded, arms hanging, his star shut in red):
|
||||
this page cannot reach its own program, after
|
||||
<span data-fact="goneSeconds">8</span> seconds without contact.
|
||||
Usually it has shut itself down; see "Getting a new link" below.
|
||||
</li>
|
||||
</ul>
|
||||
<p>"Reading Planny" shows every mood side by side.</p>
|
||||
<h4>It may be waiting for you in the terminal</h4>
|
||||
<p>
|
||||
Plan2Code sometimes stops in the terminal to ask your permission
|
||||
before it runs a command or changes a file, and this page cannot see
|
||||
that. After about 30 seconds of silence while it is working, the line
|
||||
beside Planny asks "Still working, or waiting on an approval in your
|
||||
terminal?" Have a look at the terminal: answering there sets it going
|
||||
again.
|
||||
</p>
|
||||
<p>
|
||||
If it stays quiet a couple of minutes longer, the line changes to
|
||||
"Still working on it. Longer tasks can go a few minutes between
|
||||
updates", with Planny still
|
||||
in his working pose. It may be busy, or still waiting on you in the
|
||||
terminal; the terminal is where to look. A build that said a task may
|
||||
take longer gets that long before the line changes.
|
||||
</p>
|
||||
<p>
|
||||
Hands-off modes, such as <code>auto</code> mode in Claude Code or
|
||||
<code>smart</code> mode in Devin, cut down on those stops, though some
|
||||
may still need you.
|
||||
</p>
|
||||
<h4>Answering anyway</h4>
|
||||
<p>
|
||||
You can keep answering and press Send while Plan2Code is not running.
|
||||
What you send is written to disk and held until something collects it,
|
||||
so starting Plan2Code again picks it up where you left off.
|
||||
</p>
|
||||
<h4>Getting a new link</h4>
|
||||
<p>The program behind this page shuts itself down:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<span data-fact="closedTabMinutes">2</span> minutes after the last tab
|
||||
showing it closes,
|
||||
</li>
|
||||
<li>
|
||||
after <span data-fact="idleMinutes">30</span> minutes without hearing
|
||||
from anyone, or
|
||||
</li>
|
||||
<li>
|
||||
after <span data-fact="maxLifeHours">4</span> hours, whatever is
|
||||
happening.
|
||||
</li>
|
||||
</ul>
|
||||
<p>
|
||||
To get it back, ask Plan2Code in the terminal to resume the session,
|
||||
or run the step's command again, and use the new link it gives you.
|
||||
Everything you typed, sent or not, is still there.
|
||||
</p>
|
||||
<div class="handoff-command" data-copy>
|
||||
<code class="handoff-code">resume the session and print the web console address here</code>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- Tab 16: Keyboard and preferences -->
|
||||
<section class="help-panel" data-tab="prefs">
|
||||
<h3>Keyboard and preferences</h3>
|
||||
|
||||
Reference in new issue
Block a user