From 2e2edd538abaf0c183706d644ce7ede767df3141 Mon Sep 17 00:00:00 2001 From: Justin Parker Date: Thu, 5 Nov 2026 17:08:41 -0800 Subject: [PATCH] Condense the v3.0.0 changelog to its main features, set the release date, and rebuild the landing page around the desktop app AI Assisted --- CHANGELOG.md | 117 ++----- docs/index.html | 853 ++++++++++++++++++++++++++++++++++++++++-------- version.json | 2 +- 3 files changed, 737 insertions(+), 235 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 5b318f0..121a10a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,113 +6,34 @@ All notable changes to Plan2Code will be documented in this file. ### ✨ Added -- **desktop app**: a cross-platform app (Rust, Tauri) that is the single window for working with an AI agent. It opens the Plan2Code dashboard as its main surface, runs Claude Code, Devin or Codex in a pseudo-terminal panel it owns, and adds a **New Session** button that replaces the agent with a fresh one on a brief the app builds from its own record of the session, with the in-progress work and recent activity carried over. Every console page (Ask, Workspace, Help, Preferences, Git, Notebook) opens inside the app, not a separate browser tab. -- **desktop app**: **Update skills** in the bar brings the installed skills level with the app from the exact release the app ships, with live progress and a **Reconnect the console** offer once it finishes; an app older than the installed skills says so instead of trying to fix it by updating skills again. -- **desktop app**: the window's own title (and so its taskbar entry) now reads **Plan2Code - <folder name>** once a project is open, instead of a plain **Plan2Code** every window shares; two or more windows on different projects read apart without opening each one to check. -- **helpers**: a helper (subagent) no longer has to run on the session's own model and effort. A new shared reference, `helper-strength.md`, shipped in Pathfinder, Quick Task, Implement, Implement + Review and Review, matches each helper job to a strength (`light`, `standard`, `strongest` or `inherit`) and an effort (`low`, `medium` or `high`) from signals that can be checked, with floors, one-step escalation and a fallback order for tools that cannot set either, and never names a model or vendor. Review, Implement + Review and Pathfinder name the strength for the helpers they start, and the rules apply in terminal sessions too. -- **helpers**: Plan and Revise Plan now offer helpers (subagents), with the web console's **Subagents** button in the top bar, on by default like the other opted-in skills. Each skill has its own rule for what is independent enough to hand off. Plan uses helpers for reading the sources the person names, mapping separate areas of the codebase in Phase 2, gathering evidence on each open tech choice in Phase 4, and one fresh cross-check of the PLAN-DRAFT against the conversation in Phase 7; questions, decisions, sign-offs and the writing of the PLAN-DRAFT stay with the session. Revise Plan uses read-only lookups on the code behind affected and at-risk completed tasks at Steps 1 and 2 and, only after approval and when a revision touches 3 or more phase files, one helper per phase file to apply the approved edits under `specs/`. The rules live in each skill's Helpers section, so they apply in terminal sessions too. `helper-strength.md` now ships in both, with a row for each new kind of helper job (Plan's recon reuses the lookups row) and the PLAN-DRAFT cross-check held at `standard` or above, like a review. -- **web console**: the Subagents dialog has a **Helper strength** choice under Helpers: **Balanced** (the default), **Thrifty**, **Best** or **Match my session**, saved per project and skill and delivered to the agent as a `Helper strength:` line. Helper reports may say what each helper ran with (`strength`, `effort`), and the Subagents tab shows each as a colored badge with a small three-bar level mark (teal for low, amber for medium, violet for high; the session's own model in plain gray), while screen readers still hear one line, such as "Standard, medium effort". -- **web console**: picking a spec on the dashboard that is not documented yet now shows its main files as read-only tabs in the top bar, like the **Overview** tab of a documented spec: **Map** for a Pathfinder map (`pathfinder/map.md`) and **Plan draft** for Plan's live `PLAN-DRAFT-*.md`, each when it exists. Once the spec has an `overview.md`, Overview replaces them. -- **web console**: start Pathfinder, Plan or Quick Task (on **Start fresh**) or Revise plan (on a picked spec with no plan change waiting) from a Notebook tab. A lit card's confirm pane offers **Start with a note from your Notebook**, with the tab list, a preview of the whole tab and up to five ticked pictures (the first five start ticked; a tab over 50 KB says so). The skill's first box arrives filled with the tab's text and pictures, editable, and the agent reads it only once you send it; nothing about the tab rides the launch itself. The tab then shows a **sent** badge and a "Sent to · " line in the Notebook, and the Notebook's privacy line now reads: the agent never reads your Notebook, and a tab reaches it only when you start a workflow with it. -- **web console**: **Ask for suggestions**, a chip in the **Notes on this** panel of an open choice, multi or confirm card, asks Plan2Code what it would pick and why, on its own: it sends one request for that card (with anything typed in the note box), and every pick already staged, on that card or another, stays staged. The request shows in the thread tagged **Asked for suggestions** until the agent replies there, with the chip held off meanwhile; `console.md` tells the agent to answer a `Suggestions wanted on :` line in the item's thread with each suggestion and why, re-posting the question only when that helps. A re-post that drops an option clears only the pick staged on it, and a banner names the question. -- **web console**: **Activities**, a die in the top bar right of the megaphone, opens a window of small games to play while you wait, say through a long build. The first is **Snake**, built in-house from local files (arrows or WASD, space or Enter to start, P or Enter to pause and play on, Esc to close). It speeds up as it grows and gets wilder each level: every new level opens in Slow-mo (which eases back to full speed as it runs out, never with a jolt), and every 5 foods brings something new (rocks that flash before they land, mystery boxes, portals, tail-cutting comets, chaos, then ice, where a turn slides two steps before it takes), five power-ups turn up on their own (Shield, Slow-mo, Magnet, Ghost, Scissors), a mystery box holds one of nine surprises (Jackpot, Gold rush, Lights out, Disco fever and more), each level serves its own fruit (an apple, then cherries, an orange, grapes, a banana, a strawberry, watermelon, a peach and a golden apple) on its own scenery (meadow, desert, lagoon, starry night, carnival, ice, volcano, gold), the last food of every odd level from 3 on is a crowned four-cell boss fruit that takes three bites, a runaway fruit on little feet hops away until you corner it or tire it out, quick eating builds a combo up to x5, and passing your best plays a fanfare. A level, power-up or surprise banner opens on the half of the board away from the snake and fades almost clear while the snake is under it or heading into it, so it never hides a crash. The start and end screens count the surprises you have found so far and hint at what waits next. The second is **Mini golf**: goofy holes seen from above on themed courses (see the course dashboard further down), among them Pirate Cove (a shark sea, cannonballs, a kraken, a ghost ship, a skull to putt through) and the Caves of Doom (dark but for the ball's light, with lava, a bottomless pit, mine carts, stone crushers and a sleeping dragon), played arcade style: the aim follows the mouse (or held arrows, turning faster the longer they are held) and points back at the cup after every stop, holding there until the mouse really moves so a click never swings it, one click or space starts a power meter beside the ball and a second sets the power (slow near the bottom for soft putts, fast near the top, with a gold MAX band for a 1.15x putt and a red overswing band past it that shanks the ball), a 6 second shot clock starts the meter for you, a meter left running dribbles the ball, and holding space or the mouse fast-forwards the roll, with par per hole, at most 8 strokes a hole, and its best kept as the lowest full round. Glowing power-up pads help the next putt: a free putt, a cannon shot, a ghost ball that floats over water, a cup magnet, a rubber duck that keeps its speed off walls, a huge cup, and a spyglass that shows where the putt will roll. With two games, a picker chooses between them. A new question, a sign-off or a finish pauses the game at once and shows a banner with **Go to it**, so a game never hides your turn; hiding the page or clicking away pauses it too. While that banner is up, nothing resumes until you click its **Unpause game** button, so a key or click already on its way cannot wave the banner away unread; after **Go to it**, or once you close and reopen the window, a game key or a click on the board plays on. Resuming puts the your-turn banner away until the next question. Every round start and every play-on after a pause counts down 3, 2, 1 first, so a game never moves before you are ready. The window's header shows the current game's best. Best scores (shown beside the score and after each round, cleared by **Reset best scores**; the score line is a pair of colored chips with a meter filling toward the best, which glows when you reach it, turns into a rainbow with a burst of sparks when you pass it, and ends the round with **New best!**) and the last pick are saved privately in `~/.plan2code/console/looks.json` and never reach the agent. **User Preferences → Sounds & activities → Show Activities** hides the die everywhere, and Help has a new Activities topic. -- **web console**: Activities has a third game, **Light Trails**: every rider leaves a glowing wall behind it, and the last one still moving wins the heat. Arrows steer and space spends a boost charge (two a heat, up to three). Riding into something holds you in place for a split second first, so a turn pressed then still gets you out (rivals get no such grace). A round runs through nine arenas, from Neon Grid to the Golden Arena, each on its own scenery: a win moves you on, and a crash costs one of five lives and runs the heat again, and every 750 points gives a life back (up to nine). Each arena brings a rival more (Zip, Bolt, then Echo, who ride sharper the further you go) or something new: power-up pads at 2 (Boost, Phase through trails, an Eraser that wipes the trails around you, Slow-mo for the rivals, coins, a beating Heart for a life, and a Shield, held from heat to heat until it takes a crash for you), crystals at 3 with a Laser that zaps rival heads in your line through their trails and Score x2, portals at 4 with a Wide Trail three cells across (you can turn onto the side cells just laid, so a corner never crashes you) and Coin Rain, walls that close in a ring at a time, flashing first, at 5 with a Hyperjump out to open space, and at 6 a rainbow Mystery pad that could be any of them; the first pad of each kind in a run says it is new. A rival out while you still ride scores points, and more when your trail or your laser got it. You ride with Planny's star eye, and the start and end screens show the furthest arena you have reached and what waits next. -- **web console**: Activities has a fourth game, **Bug Hunt**, an arcade shooter. Planny's ship slides along the bottom (the arrows move it, held space fires) and squashes waves of bugs that swoop in from the sides into a swaying formation, then break off and dive at you. The first waves each bring a new bug: the everyday **Bug**, a **Beetle** that splits in two, a zigzagging **Race condition**, an **Exception** that throws things, a **Null pointer** that shots pass through while it fades, and a **Firewall** that soaks up shots. Every fifth wave is a boss: the **Memory Leak**, which grows while you wait, the **Spaghetti Monster**, whose tentacles have to go first, and the **Heisenbug**, which is only there when you look, then round again, tougher. Squashed bugs drop coins and now and then a power-up (Spread shot, Rapid fire, Shield, Slow-mo, Magnet, Refactor, which cleans up the screen, and a 1UP), quick kills build a combo up to x5, and a wave cleared without a hit scores extra. The board is Snake's checkerboard scrolling past with bits of code drifting by, with new scenery every five waves (the Codebase, Legacy Code, Production, the Cloud), and the start and end screens count the 16 bugs, bosses and power-ups found so far. -- **web console**: Activities has a fifth game, **Sunset Drive**, a road racer against the clock. Planny drives a convertible down an endless road seen from behind, with bends, hills, traffic and scenery scrolling past: hold up to drive, down to brake, the arrows to steer, and space burns a nitro can for a burst of speed. The clock sits big in the top middle, blinking red and swelling on every tick in its last ten seconds. Each stage ends at a checkpoint that adds time, and just before it the road splits around a median: the side you keep to picks the next of six roads (Sunset Coast, Canyon Road, Maple Valley, Snowcap Pass, Neon City and Starlight Highway), each with its own sky, props, traffic and points bonus, the harder ones worth more. Coins, clocks and nitro cans line the road, a car passed close at speed scores a close call, and catching up with a car or hitting a palm, cactus or rock on the shoulder costs you speed. As the fork is called, a postcard of each road (its sky, hills, road and scenery, with its name and points bonus) shows in the top corner on its side, the side you are on lit. Spinning **?** boxes on the road hold power-ups, queued up to three: while one is held, space fires the oldest instead of a nitro can, and timed ones run side by side (one fired again while it runs adds its time). **Rocket Hop** leaps over the traffic and the shoulder, **Ghost Car** drives right through cars and props, **Coin Magnet** pulls in every coin across the road, **Monster Truck** flings the cars it hits into the sky for points and flattens props, and **Coin Storm** turns the traffic ahead into coins. The round ends when the clock runs out, and the start and end screens count the roads found so far. -- **web console**: Activities has a sixth game, **Stack Deploy**, a one-button tower stacker. A block slides back and forth above the tower and space, up or a click drops it: the overhang is sliced off and tumbles away, so the next block is narrower, and a block that misses the tower ends the round with the camera pulling back over the whole tower. A drop dead on is a **Perfect**: nothing is sliced, the thunk climbs a scale with each one in a row, the bonus multiplies up to x5, and every third in a row grows the block back. Gold blocks from floor 15 are worth more and grow it twice as much. The slide speeds up from floor 10, and the floors bring twists: blocks from either side that may turn back (20), lag spikes that freeze a block for a beat (30) and wind (40), then a rush through the middle (70) and everything faster (90). The tower goes from server racks to office floors, glass towers and rockets under a sky that turns from day to space, Planny rides the top block (and wobbles after a sloppy drop), and a dashed line marks the highest floor ever reached, which the start screen names with the next style to reach. -- **web console**: Activities has a seventh game, **Bumper Ring**, sumo in bumper cars on a platform over the void. Held arrows push your car that way and momentum carries it; cars bounce off each other and the one closing faster rams and wins the exchange, while two cars leaning in are a pushing match. Space dashes (two charges a heat, one back every six seconds, up to three). A car whose center goes past the edge falls, and the last car on the ring wins the heat: a win moves on, a fall costs one of three lives and runs the heat again. Rivals rev before they dash, so a quick sidestep can send one flying off on its own. Nine arenas, from the **Training Mat** to the **Grand Final** and then endless, sharper Finals, bring five rivals with their own ways (the Bully, the heavy Turtle, the Sniper, the Scrapper and the Mirror, who copies your moves), power pads (Heavy, Spring, Charge, Shield, Grow, Ghost and Slick), bumpers, ice, a turntable, holes in the floor, a magnet and a ring that turns square. After a while the ring shrinks a flashing band at a time, then goes to sudden death, so every heat ends. Knockouts go to the last car to touch the one that fell, quick ones build a combo up to x5 and two at once count double, and the start and end screens show the furthest arena you have reached. -- **web console**: Activities has an eighth game, **Rapids Run**, a fast vertical scroller on a winding river. Planny pilots a jet-skimmer up a river that scrolls down the board, its banks narrowing and splitting around islands: the arrows steer, held up speeds up for double points per distance, held down slows, and held space fires. The battery drains all the while (faster at speed), so run over charge buoys to top it up, or shoot them for points if you can spare the charge. A bank, an island, a foe, a bolt or a flat battery costs one of three lives and starts the stretch again from the last dam (from the basin's mouth once a mini-boss is reached). Each stretch ends at a dam you must blast open to pass, for a stretch bonus and a new stretch name: eight stretches from **Willow Run** to **Old Lock**, then endless, quicker Night Water. The river's foes arrive a kind at a time (patrol skiffs, bob mines, gull drones, bank sentries that shoot back, whirlpools that tug and darters that swerve into your lane), every fourth dam is guarded by a mini-boss (the Dredger, Ironclad and Old Leviathan), and crates hold Spread shot, a Shield, a Magnet and a Surge. Quick sinks build a combo up to x5, skimming a bank at speed scores, the score shows big at the end, and the start and end screens show the furthest dam blasted. -- **web console**: Activities has a ninth game, **Hot Potato**, arena tag with a fizzing bomb: a merge conflict with its `<<<<<<<` markers showing. Held arrows run, whoever holds the bomb runs a little faster and passes it by touching someone, and whoever holds it when the fuse runs out is blown out of the match in a cartoon cloud, then waddles off charred. The fuse ticks quicker as it burns, the bomb grows and glows redder, and the edges pulse in the last second; each fuse in a match is shorter than the one before. Someone just handed the bomb cannot pass it on for a moment, and nobody can hand it straight back while three or more are left (a white ring at their feet shows who is safe); handed it at the last moment, you still get time to pass it, since a pass tops the fuse up to 1.4 seconds, once a fuse for each runner. Space dashes: a lunge for a tag while you hold it, a dodge while you do not, and rivals crouch before they lunge, so a quick sidestep gets you clear. The last one standing wins the match and moves on through nine venues, from the **Break Room** to the **Finale** and then endless, sharper Finales, bringing five rivals with their own ways (the Sprinter, the Hider, the Trickster, who feints, the Pal and the Clingy), pickups (Freeze, Sneakers, Extra Fuse and Swap), long rows of server racks, a roof with no wall on one side, ice, conveyor belts, a blackout and two bombs at once; being blown up costs one of three lives and runs the match again. Hot passes with under a second left chain a streak up to x5, and the start and end screens show the furthest venue reached. -- **web console**: Activities has a tenth game, **Crossing Rush**, a lane-crossing race. Planny and two rival hoppers hop up a strip of lanes a cell at a time, one hop a press: roads of cars and trucks, rivers where you ride the logs and turtles, train tracks that flash red and ring a bell before the train, and grass with bushes and rocks in the way. A car, a train or the water sends a hopper spinning back to the last grass row rather than out, so every heat ends with someone at the top, and the view follows you with a race bar beside it showing everyone's height; a hopper sent back stands dazed for 2 seconds before it may hop again. Pickups stack as you land on them and space uses the oldest first: **Spring** leaps two cells the way you face, **Shield** lets cars and trains through for 3 seconds and **Horn** stops the nearest road, while a **Coin** scores at once; the stack empties every heat. First to the top wins the heat and moves on through nine zones, from **Side Street** to **Rush Hour** and then endless, quicker Rush Hours, bringing logs, trains, diving turtles, trucks and lanes that speed up, a dusk lit by headlights, rivers that turn round and icy lanes that slide you on, and four rivals with their own ways (the careful Hopper, the Daredevil, the pushy Bruiser and the Tagalong, who follows you up). Second or third costs one of three lives and runs the heat again, though the first two zones let second place through. Quick forward hops climb in pitch, clean wins in a row multiply the win up to x3, a car through the cell you just left is a close call, and the start and end screens show the furthest zone reached. -- **web console**: Activities has an eleventh game, **Bounce Road**, a fast scrolling road seen from above. Planny races a springy toy car up a road laid across a giant's house and yard: hold up to drive, the arrows to steer and press space to jump, a faster jump going further. Bump a rival toy car sideways off the road, or land on one to flatten it and bounce up again, and land on another before your wheels touch the road to build the bounce chain, up to x8; every stunt in quick succession (crushes, bump-offs, jumps over holes, trains, balls and barriers, a ramp's big air, close shaves, boost strips) steps a combo that multiplies the points up to x4. Ten stages, each bringing something new, from **Chalk Lane** on the patio through **Kitchen Floor**, **Toy Room**, **Garden Pond**, **Rooftop Gutter** and **Night Lights** (in the dark) to **Monster Mash**, where the Monster truck must be stomped five times, then round again, quicker and meaner. The road has cracks, broken bridges, drawbridges, swaying bridges, road that crumbles behind you, ramps, boost strips, oil slicks, cone and toy-block chicanes, a toy train crossing, rolling balls, sprinklers, gusts of wind and things that fall where you are heading, every hole jumpable at 80% of the top speed after a warning sign and a run-up. Ten rivals, all keener the further you go (they block your line, swerve from under your landings, hop the gaps and keep the pack close): the Zigzag, the Brick (who brake-checks you), the Frog, the Nudge, the Hauler, the Sneak (who drops cones), the Bruiser, the Racer to catch, the Cop (who chases and pushes you toward the edge) and the Monster truck. There are four power-ups (Spring, Bubble, Nitro and Mega wheels), and every car is drawn in full toy-car detail. A stage line pays a bonus for beating its par time, a stage crossed with no life lost gives a life back, and the start and end screens show the furthest stage reached. -- **web console**: Activities has a twelfth game, **Ghoul Rush**, a fast, dark run-and-gun through a haunted house. Planny sprints left to right through a mansion a room at a time, the view scrolling with him, lit only by his glow, his flashlight's cone, candles, moonlight and the odd flash of lightning, with eyes burning in the dark around him: hold left or right to run, up jumps (let go early for a short hop), down drops through a shelf, and held space fires his flashlight blaster ten times a second the way he faces. Grab each room's key, then reach its door, while a horde pours in from the edges of the view. **Zombies** sprint once you are close, **crawlers** drag themselves up through loose boards, **bats** swoop at your chest, **ghosts** can only be hit (or hurt you) while solid, **skeletons** throw bones you can shoot down, **hellhounds** crouch growling and lunge, **widows** drop from the ceiling as you pass under, **wraiths** shriek and dive at where you were, and **bloaters** lob acid that leaves burning puddles and burst when they die; a shot to the head or a stomp from above doubles a kill, and quick kills build a chain up to x10 that runs out in 1.2 seconds. Pits, one-way shelves, crumbling boards and falling chandeliers (which crush whatever is under them) fill eight rooms, from the **Foyer** to the **Crypt**, with a boss every fourth: the **Rotting Gourd**, a giant rotten pumpkin that hops to where you stood and shakes loose gourdlings, and **Old Rattlebones**, who throws volleys of bones and slams shockwaves you jump. Power-ups (Spread shot, Rapid fire, a Garlic shield and a 1UP), souls, a time bonus per room that sends zombies in from the edges once it runs out, a flawless bonus and a life back for each boss add up, a hit or a fall costs one of three lives and restarts the room, and the start and end screens show the most stages cleared in a run. -- **web console**: **Mini golf** now has six themed courses of eighteen holes each, picked from a **course dashboard** that opens from its card: a card per course with a picture of one of its holes, its line, its par and your best round on it, walked by the arrows like the game picker, with **All courses** to get back; once a round is over, space or a click goes back to the dashboard rather than replaying the same course. **Pirate Cove** and the **Caves of Doom** each grow from nine holes to a full eighteen, and four new courses join them: **Dino Valley** (a prehistoric jungle and volcano), **Candy Carnival** (a sweets land), **Cosmic Glow** (black-light glow golf in outer space, where black holes bend your putt) and **Frosty Peaks** (a winter wonderland where the ball glides on ice). Two new hazards came with them: ice, where the ball barely slows, and gravity wells that pull a putt in or push it away. Each course keeps its own best round (`activityBestGolfPirate` to `activityBestGolfFrost` in `looks.json`), and the Mini golf card on the picker counts the courses you have a best on. -- **web console**: the Activities window now opens on a **picker**, a card for each game with a little cover scene, a line about it, its best score and a **Last played** tag, in place of the old row of buttons above the board. A card opens its game, the arrows walk the cards, and **All games** goes back. One game plays at a time: leaving for the picker keeps the round paused on its card (and reopening the window goes straight back into it), and picking a different game ends it. -- **web console**: **User Preferences → Sounds & activities** has a **Play game sounds** switch under Activities, so the games can play silently while the page's own cues (a new question, a reply) still sound. It covers every game's sounds and the window's own (the 3, 2, 1 and the new-best burst), turning it off silences a game playing now, it is grayed out while **Play sounds** is off (and keeps its tick for when sound comes back), and **Back to default** turns it back on. Saved as `activitySounds` in `looks.json`. -- **web console**: Ghoul Rush's flashlight blaster now heats up, so holding (or hammering) space is no longer the whole game: about three seconds of fire go at the full ten bolts a second, then each bolt waits longer, down to one a second, with a **LIGHT** gauge always at the right of the HUD: a bar that fills as the blaster heats and empties as it cools, notched where the bolts start to slow, pale, then amber near the notch, then red (reading **HOT** and throbbing) past it, and in Rapid fire's pink while that runs. Let go of fire and it starts cooling after a fifth of a second, the hottest blaster in about two seconds, so firing in bursts keeps it quick. Rapid fire's bolts add no heat and ignore it. -- **web console**: Ghoul Rush has four more power-ups that are not about the blaster: a **Lantern** pulls the dark far back for 15 seconds, **Bat wings** give one flap in the air per jump for 12 seconds (a press just before landing still jumps on landing), a **Church bell** holds every monster but a boss still for 4 seconds and lets none in until it stops or you reach the door, and an **Hourglass** puts 20 seconds back on the clock. They lie in the Gallery, Library, Kitchen, Conservatory and Attic and drop from kills, and power-ups now drop twice as often, so the blaster ones turn up as often as before. -- **web console**: every Ghoul Rush room but a boss's now has a **TIME** clock in the HUD (70 to 80 seconds by the room's length), red with a tick a second in its last ten; at none it costs a life and the room starts over with a full clock. -- **web console**: Ghoul Rush has music: a track for each room (a haunted music box in the Foyer, a 9/8 synth in the Portrait Gallery, creeping pizzicato in the Library, a gothic organ for the Rotting Gourd, a cauldron swing in the Kitchen, a 5/4 synth in the Conservatory, a phonograph foxtrot in the Attic and a dark-synth fight with Bones in the Crypt). Each plays only its drone and bass in a quiet stretch and grows fuller as monsters close in and in the clock's last ten seconds, with all of it in a boss fight. It plays under **Play game music**, like Sunset Drive's songs. -- **web console**: Light Trails has background music: five recorded songs that play one after another, each in full, for as long as a run lasts. Every new run shuffles them into a fresh order and starts the first from the top, never the song the last run was playing, and once all five have played they are shuffled again. A pause picks the song up where it stopped. It plays under **Play game music**, at the game's own **Music** slider. The light cycles' engine drones (yours and the nearest rival's) are much quieter now, so the songs carry the run, and the game's other sounds are a little louder (1.4 times), so they still cut through. -- **web console**: a game with music has its own **Music** volume slider in the Activities window, beside **Full screen**, remembered per game. Sunset Drive starts at 70 and Ghoul Rush at 50, so its music sits under the house's sounds. The slider is dimmed, and says why, while **Play game music** is off. -- **web console**: Ghoul Rush hides treasure up high, over each room's key shelf (but a boss's): **crystals** worth 250 points each, and in three rooms **Silver bolts**, a power-up found nowhere else whose bolts go on through every monster they hit for 10 seconds. None of it is reachable with one jump; a jump and a **Bat wings** flap from the key shelf takes it, and each of those rooms now has Bat wings on the way. -- **web console**: in Ghoul Rush, a zombie, crawler, spitter or gourdling that reaches the edge of a pit or a drop now stops for a moment, a "?" over its head as it thinks about it, then leaps: across a pit up to 10 units wide to floor at its own height, further down to a lower floor (the Kitchen's 12-unit pit from the counter to the floor), and straight down off a ledge. Wider pits and floor higher than a step still stop it. -- **web console**: Ghoul Rush's house drone is softer, and softer still in the Portrait Gallery and the Attic, where it is pitched higher and carried most. -- **web console**: **R** starts an Activities game's round over, from the 3, 2, 1, whether it is running, paused or finished. In full screen, the panel beside the board now holds the game's **Music** slider too. -- **web console**: in Ghoul Rush, two or more zombies, runners, crawlers or gourdlings bunched under you while you wait on a shelf now climb over each other at once, arms up, to reach you, so camping over a crowd for a run of stomps no longer works; the pile comes back down once you move off. A climber's raised arms hurt you if you land on them; only a landing on its head, between them, is a stomp. -- **web console**: Ghoul Rush no longer rewards camping near the door to farm the endless stream of monsters: each kill of the room's horde (and of the dead that come once the bonus runs out) is worth 80% of the last one in that room, down to a tenth of its points, and never drops a soul or a power-up. The room's own monsters score and drop as before. -- **web console**: Ghoul Rush has three new monsters that sometimes come in place of the usual ones: the **Runner**, a skinny zombie that sprints and falls to one bolt, and gives a high shriek and a red "!" at the screen's edge as it comes into view, so one coming up behind you is heard first; the **Glutton**, a fat, slow zombie that takes five times a zombie's bolts (15), is only bruised by a stomp, and never leaps or climbs; and the rare **Huntsman**, a big spider on the floor that crouches, then springs at you as high as you are (up onto a shelf) and takes twice a widow's bolts. -- **web console**: Ghoul Rush's zombies, runners and crawlers now climb walls up to 8 high after the same moment's thought they give a pit, and walkers cross a crumbling board laid level with the floor over a pit while it is there (falling in if it gives way under them) instead of stopping at its edge. -- **web console**: the Rotting Gourd fight in Ghoul Rush is harder: the Gourd picks one of three moves at random, never one three times running: its hop onto where you stood, a spit of two acid globs (after a half-second shake) that leave burning puddles, or a quake that leaps straight up and sends a shockwave along the floor both ways when it lands (a glowing orange crest trailing green embers, lit in the dark, so it is easy to see coming). To keep that fair, the Ballroom's arena is now stacked with balconies in three tiers to move around on: up on one over the Gourd's head it only spits at you, never hops; each corner keeps a pocket its hop cannot land on; it shakes a little longer (0.85 s) before each move and has less health (65, down from 80); and its gourdlings jump up onto the balconies after you and run off their ends to follow you down. -- **web console**: every Ghoul Rush monster now has its own voice, a sound for each thing it does: coming in, climbing or hopping, growling, lunging, shrieking, diving, spitting, throwing, taking a hit and dying. That covers the zombie, runner, glutton, crawler, bat, ghost, wraith, skeleton, gourdling, hellhound, widow, huntsman and bloater, and both bosses, who also have their own wake-up, hop, slam, wind-up and death. A zombie's gurgle, a skeleton's hollow cackle and a hellhound's growl now tell you what is coming before you see it. Rapid fire on one monster plays its cry at most about seven times a second, and a Rattlebones volley plays once for its three bones. -- **web console**: Ghoul Rush is now played in **stages**, picked as you go, so no two runs go the same way. Every run starts in **the Long Hall**, a long, easy walk with only zombies. Out of it, and out of every boss's room, you choose the next stage from two you have not played that run (one, once a single stage is left). Each card shows the stage with its boss standing in it, its name and its boss; left and right pick one out, space or up goes in. A stage is three rooms and then a boss: **the Manor** (Foyer, Portrait Gallery, Library, then the Rotting Gourd in the Ballroom) and **the East Wing** (Kitchen, Conservatory, Attic, then Old Rattlebones in the Crypt). Clear every stage and you **escape**, a win with its own fanfare, instead of the rooms coming around again. Each stage cleared makes the next one's monsters quicker, tougher and let out sooner, and its boss stronger and worth more. A boss now always gives a life back, and you can hold up to **nine** lives (up from five); the 1UP also drops a little more often. The start and end screens show the most stages you have cleared in a run, with a dot per stage. -- **web console**: an Activities game can go **Full screen**: a button under the board (or `F`) gives the game the whole screen, with the browser's own full screen where it allows one. The board grows as big as its shape allows, and the room its shape leaves holds a panel with the game's name, the score line (score, the meter toward the best, the best) and **Exit full screen**: beside the board on a wide screen, along the bottom on a tall one, and where the shape leaves no room (Sunset Drive on a 16:9 screen) the board gives up a little width for it, so nothing is ever laid over the play. The pointer hides after two still seconds. `F`, `Esc` or **Exit full screen** puts it back. In the desktop app the window goes full screen too, with the console laid over the bar and the terminal. When Plan2Code needs you (a question, a sign-off or a finish) and pauses the game, the window goes back to its own size so the banner and the page show. -- **web console**: every Activities game now has a full soundscape, still made in the browser with no audio files. The sound engine gained noise, sweeping filters, layered sounds and held **hums** that follow the action, so engines rev and fall away with your speed (Sunset Drive's V8 shifts through five gears, with tire squeal, wind and traffic that passes with a Doppler drop), Rapids Run's outboard purrs over the river, Bounce Road's toy car buzzes ahead of a Monster truck's rumble, Bumper Ring's electric cars whine over a crowd, light cycles drone, fuses hiss louder as they burn down, and every Mini golf course and Ghoul Rush room has its own ambience. Crashes, splashes, explosions, landings, pickups, combos, bosses, new bests and game over each get a sound of their own in every game. A hum fades by itself the moment a game pauses or closes, and **Play sounds** still silences everything. -- **web console**: Activities games can play chiptune music, written as note data and played by a small sequencer in the page (pulse-wave leads and arpeggios, a triangle bass and a noise drum kit). A track builds with the action. Sunset Drive gives each road its own song (surf rock on Sunset Coast, flamenco on Canyon Road, a 70s funk chase through Maple Valley, uplifting trance on Snowcap Pass, darksynth in Neon City and retro sci-fi on Starlight Highway), each starting as a lone bass line at a standstill, bringing in drums, chords and the lead as you pick up speed, and playing quicker on nitro; reaching a new road crossfades into its song. It is off until you turn on **Play game music** in **User Preferences → Sounds & activities**, and it fades the moment a game pauses or closes. -- **web console**: every Activities game with lives shows them as a solid pink pill with a heart per life, readable at a glance, and the banners in Bug Hunt, Sunset Drive, Stack Deploy and Bounce Road now fade almost clear while you, or whatever is coming at you, are under them, as the other games' banners already did. -- `plan2code` opens the app automatically when a desktop is available; `plan2code --classic` (or no desktop, e.g. over SSH) keeps today's terminal-only flow unchanged, and the installer brings the app in alongside the skills and the command. -- **custom agents**: add your own agent CLIs in the web console under **User Preferences → Agents & models** (name, command, arguments with `{prompt}` and `{model}` tokens, start prompt, bypass arguments, models) with a **Test** button that shows where the command is found. They are saved in `~/.plan2code/agents.json`, listed after Claude Code, Devin and Codex by both the `plan2code` command (`--cli <id>` picks one) and the desktop app, and New Session reuses the same agent. A broken file or entry is skipped with a warning and never stops anything. `/plan2code` only works in an agent that loads the installed Plan2Code skills; a blank start prompt starts the agent with nothing typed. -- **desktop app**: when no agent CLI is installed, the first-run checklist and the launch card explain what to install, with each agent's install command, an **Install page** link, and a **Check again** button that finds a newly installed agent (or a custom one) without restarting the app. -- **desktop app**: the taskbar entry now shows when Plan2Code needs you, mirroring the console's tab icon. Windows: a green dot on your move (a finished screen too, while it still offers a button to press, such as back to the dashboard or a review), a red dot on needs attention (or a finished screen whose press was never collected), none while busy or once nothing is left to press, and one short burst of flashes when the window is not focused (the button stays lit until focused). macOS: a red `!` dock badge on needs attention and one bounce (the system badge cannot be green). Linux: a count badge where the desktop supports it, plus the urgency hint. The dot clears when the agent ends, the page reloads or the page stops answering. **User Preferences → System → Desktop app** (inside the app only) has the switch **Show on the taskbar when Plan2Code needs me**, on by default and saved in the app's own `app.json`. -- **pr-prep**: a new dashboard utility, **Get a PR ready** (`/plan2code-pr-prep`), for the moment before you open a pull request. It reads what changed on the branch, asks first whether to include uncommitted work, and picks the checks that cover the changes from the project's test map (or, with no map, from commands it finds in the project's config files and confirms with you), each with a reason, plus the full suite when shared ground was touched. You untick what to skip; it runs the rest with a timeout per check and says **Ready**, **Ready with notes** (something trimmed, timed out, could not start, or a changed file no test covers) or **Not ready**. It writes a PR description to copy, following the repo's pull-request template when there is one, with the create-a-PR link (no `gh` needed), and offers to save the report as `PR-READINESS-<date>.md` in the branch's spec folder. It never commits, pushes or opens the PR. -- **test**: a new dashboard utility, **Write missing tests** (`/plan2code-test`). It asks where to look (the branch's changes, a folder or the whole project), finds the source files no test covers by matching them to tests by name, folder and imports, and offers a real coverage run on top when the project already has a coverage tool (Node's test runner, Jest, Go, or Vitest, pytest-cov and Coverlet when installed), never running it silently. The plan opens with **How this project writes tests** for each runner (folder, file naming, command, helpers, assertion style), so the new tests match the old ones; on your approval it writes and runs unit and integration tests. It never changes source code: a test that exposes a real bug is kept, on a yes, as the reproduction for `/plan2code-diagnose`. A project with no runner is offered its language's built-in one (`node --test`, `unittest`, `go test`, `cargo test`), and a job past 8 source files, 8 new test files or 2 runners can **Continue** with the top 8 gaps or **Escalate** to a PLAN-DRAFT that `/plan2code-1-plan` resumes at Phase 2. -- **test map**: projects can describe their tests in one Markdown table under `## Test map` in `AGENTS.md` (or behind one link to `.agents-docs/AGENTS-test-map.md`), with the columns `Area`, `Paths` (globs), `Run` (the command for that area) and `Shared` (`yes` when a change there reaches everything). PR Prep and Test read it to pick checks and runners, and offer to write or update it at the end of a run. **Init** proposes one when it finds test commands, and **Init Update** checks an existing map's paths and commands still match the project and offers one when tests exist but no map does; nothing is written without a yes. -- **git**: after a push or publish, or when the branch is pushed with nothing left to commit, the git skill now names `/plan2code-pr-prep` as the likely next step: run the checks and write the PR description. -- **web console**: a one-answer question (a pick-one list, or a menu) now has a **Clear** button under its options that takes the card back to how it arrived: no pick, and nothing in **Something else**. A radio pick cannot be unticked by clicking it again, so before this a stray pick could only be swapped for another. The button shows only while the answer has not been sent. - -- **contributors**: `npm run play` opens the web console straight from `src/` with the server reading each page file fresh, so a change to an Activities game shows on the next page reload, without `npm run build:skills` or a reinstall. -- **first run**: when no agent CLI can be used (a fresh install, an agent installed but off PATH, the only agent gone after an uninstall, or `--cli` naming a missing agent), the `plan2code` command and the desktop app show one **setup page**: the web console running an agent-less `setup` workflow. It lists each built-in agent (Claude Code, Devin, Codex) as **found**, **found outside PATH** or **not found**, with install commands for your OS, an install page link and **Check again**, plus four starter templates (Pi, Gemini CLI, OpenCode, GitHub Copilot CLI). **Use it from here** makes an off-PATH agent usable without a restart; once an agent is found the run carries straight on, the same browser tab (or the app's launch card) picking up where it left off. With no window or no person, the command prints the install steps and exits 127. One shared agent list (`src/launcher/agents.json`, installed to `~/.plan2code/bin/`) and one lookup rule (`agent-lookup.mjs`, with a Rust twin in the app held to the same fixture cases) serve the launcher, the console and the app; the maintainer skill `plan2code-model-update` is now `plan2code-launcher-update` and re-checks the list's install data too. -- **desktop app**: the Implementation Loop setup has **Set strength per phase**: pick Thrifty, Balanced, Best or Match my session for each phase of the spec, and each phase's agent starts on the model and effort that strength maps to for the loop's agent. A phase left alone runs on the launch choice, so a loop with the toggle off behaves as before. The phase's helpers follow its strength, the one retry steps up a strength, and the loop strip and the loop report show what each phase ran on. Claude Code and Devin ship with a mapping; for any other agent **Strengths in the loop** in User Preferences, Agents & models, maps each strength to one of its models. +- **desktop app**: a cross-platform app (Rust, Tauri) that is the single window for working with an AI agent. It opens the Plan2Code dashboard as its main surface and runs Claude Code, Devin, Codex or your own agent in a terminal panel it owns, with every console page (Ask, Workspace, Help, Preferences, Git, Notebook) inside the window. **New Session** replaces the agent with a fresh one on a brief the app builds from its own record of the session, so in-progress work carries over. **Update skills** brings the installed skills level with the app, and the taskbar shows when Plan2Code needs you. `plan2code` opens the app when a desktop is available; `plan2code --classic` keeps the terminal-only flow. +- **implementation loop**: the app builds a spec phase by phase, each phase in a fresh agent, and writes a report. **Set strength per phase** runs each phase on the model and effort of a chosen strength (Thrifty, Balanced, Best or Match my session), the loop strip and report show what each phase ran on, and the end screen offers **Back to the dashboard** and a way to ask a stopped loop a question. It replaces the `plan2code-loop` CLI (see Breaking). +- **helpers**: helpers (subagents) now run at a strength and effort matched to their job (`light`, `standard`, `strongest` or `inherit`), never tied to one model or vendor, and Plan and Revise Plan offer them too. In the web console, the **Subagents** dialog turns helpers on or off per project and skill and has a **Helper strength** choice (Balanced, Thrifty, Best or Match my session), and the Subagents tab shows what each helper ran with. +- **custom agents**: add your own agent CLIs under **User Preferences → Agents & models** (saved in `~/.plan2code/agents.json`) and start them from `plan2code --cli <id>` or the app. When no agent can be used, a first-run **setup page** lists each built-in agent as found, found outside PATH or not found, with install commands for your OS, starter templates and **Check again**, then carries on once an agent is found. +- **pr-prep**: a new utility, **Get a PR ready** (`/plan2code-pr-prep`), picks the checks that cover your branch's changes, runs them, says Ready, Ready with notes or Not ready, and writes a PR description to copy. It never commits, pushes or opens the PR. +- **test**: a new utility, **Write missing tests** (`/plan2code-test`), finds source files no test covers and, once you approve its plan, writes tests in the project's own style. It never changes source code. Both utilities read an optional **test map** (a `## Test map` table in `AGENTS.md`), which Init can propose. +- **activities**: a die in the console's top bar opens a window of thirteen small games to play while you wait: Snake, Mini golf (six 18-hole courses), Light Trails, Bug Hunt, Sunset Drive, Stack Deploy, Bumper Ring, Rapids Run, Hot Potato, Crossing Rush, Bounce Road, Ghoul Rush and Flock Dash. A game pauses the moment Plan2Code needs you, has sounds and optional music, can go full screen, and keeps its best score privately. Off until you turn on **Show Activities** in **User Preferences → Sounds & activities**. +- **web console**: start Pathfinder, Plan, Quick Task or Revise plan from a **Notebook** tab: the skill's first box arrives filled with the tab's text and pictures, and the agent reads it only once you send it. +- **web console**: answer boxes render Markdown live, **Ask for suggestions** asks Plan2Code what it would pick and why on an open question, a **Clear** button takes a one-answer question back to unanswered, a plan's Build order card has **Combine phases**, and a spec that is not documented yet shows its Pathfinder map and plan draft as read-only tabs. +- **workflows**: Finalize offers a final review and asks once before its rating questions, Diagnose lets you skip two of its opening questions, and Git names `/plan2code-pr-prep` as the likely next step after a push. +- **contributors**: `npm run play` opens the web console straight from `src/`, so a change shows on the next page reload without rebuilding or reinstalling. ### 💥 Breaking -- **the `plan2code-loop` CLI is no longer an install target, and the package is removed.** The `plan2code-loop/` directory is deleted, and with it the installer's `O. LOOP CLI` advanced option and the loop's install, update and uninstall wiring. Its docs (`.readme/autonomous-loop.md`, `.agents-docs/AGENTS-plan2code-loop.md`) are gone too, and every remaining mention across the docs, templates, metadata and comments is removed or reworded. The desktop app's **Implementation Loop**, which superseded the CLI, is a separate feature built into the app and is unchanged. - - **Stale installs are still cleaned up.** `install.js` keeps a small `removeLegacyLoopShims()` step that removes the old global artifacts (`plan2code-loop`, `plan2code-loop.cmd`, `plan2code-loop.ps1` and `node_modules/plan2code-loop` under the npm prefix) when they are present. `update()` runs it once before reinstalling and quietly skips a stale `"loop"` entry in `~/.plan2code/install.json`; uninstall runs it too. +- **the `plan2code-loop` CLI is no longer an install target, and the package is removed.** The `plan2code-loop/` directory and the installer's `O. LOOP CLI` option are gone; the desktop app's **Implementation Loop** supersedes it. Stale installs are still cleaned up: update and uninstall remove the old global `plan2code-loop` command and npm package when they are present. ### 🔧 Changed -- **web console**: **User Preferences** is now four tabs in a side list (a sideways strip on narrow screens) instead of one long column: **Appearance**, **Agents & models**, **System** and **Sounds & activities**. Look and sound settings still save as they change and now show a **Saved** mark; **Back to default** resets only its own tab (and is hidden on the two tabs it has nothing to reset), and **Done** reads **Close**. **Agents & models** is a summary table of Claude Code, Devin, Codex and your own agents, with each one's models and a **Found** / **Not found** on PATH badge, and **Edit** opens a full form per agent with **Save** and **Discard**, an **Unsaved** badge and a Save / Discard / Keep editing prompt before an unsaved edit is lost. The separate Models section is gone: each built-in agent's form lists the models that come with Plan2Code beside your own. Help shares the same tab handling, and its User Preferences topic now covers every tab. -- **docs**: all prose, help text, skill prompts and comments now use US English spelling (color, gray, behavior, canceled, -ize), and `npm test` checks it (`scripts/test-us-english.mjs`). -- **web console**: **User Preferences → Appearance → Highlight color** now offers 38 colors in two rows of nineteen, covering the range of a Paint-style picker: new **Maroon**, **Peach**, **Brown**, **Cream**, **Lemon**, **Forest**, **Mint**, **Aqua**, **Lavender**, **Pink** and **Mono** (near-black in light mode, near-white in dark). Five near twins were merged (Copper into Rust, Marigold into Gold, Mustard into Lemon, Jade into Emerald, Lilac into Violet); a saved choice of one of those keeps its twin instead of falling back to Ocean. -- **web console**: the **Subagents** dialog is wider and shorter, like the Notebook: Helpers and At most share a row, and the four Helper strength choices sit side by side, each wearing the Subagents tab's colored level badge (Thrifty light, Balanced standard, Best strongest, Match my session plain), now ordered from lightest to strongest. -- **launcher**: after you pick the agent, `plan2code` now asks whether to turn its permission prompts off (Yes by default, so pressing Enter starts it as before), and only for an agent that has a flag for it: every built-in does, a custom agent only when it has bypass arguments. `plan2code --keep-permissions` keeps the prompts without asking; with no terminal to ask on, prompts are off as before. The installer no longer prints its warning about the command starting agents with prompts off. -- **launcher**: when no agent CLI is installed, `plan2code` now prints each supported agent's install command and official page, and points at User Preferences → Agents & models for another CLI, before it exits. -- **desktop app**: a clean start is now one press. Pathfinder's **Start fresh** menu option reads **Start New Session** under the app, and sending it asks the app for its New Session (the resume command is copied first; declining the app's confirm leaves the usual finish). A finished step that names a skill to run next shows a **Start a New Session** button beside its command, also copying the command first. The plain web console keeps its wording and does neither. The app's console frame also now allows clipboard writes, so the copied command and every **Copy** button can reach the clipboard there. -- **desktop app**: the launch card's agent choice is built from the agents that are installed, so a machine with only Devin or Codex starts on it with Start enabled, instead of assuming Claude Code. -- **desktop app**: the window now opens maximized, filling the screen with the title bar and taskbar still showing; restoring it from maximized gives the old 1280x800 size. -- **launcher**: `plan2code` no longer treats an SSH or service session on macOS or Windows as having a desktop, and asks before opening a folder that looks like it is not a project (no `.git`, `AGENTS.md` or `specs/`). -- **desktop app**: the app's own bar no longer repeats the open page as a second "page: " label; the console's own bar, inside the window, already names it. The web console now knows when the agent driving it is the desktop app (the same signal that already routed `open` to the app's window) and, only there, drops advice that assumed a plain terminal: its session meter, the finished-step guide and the dashboard's red-session banner point at the app's own **New Session** button instead of a command to paste into a new conversation; its own "update available" banner, a copy-pasted shell command, never shows, since **Update skills** already covers it in one click with no shell involved; and a slash command still offered to continue a step says to paste it into the app's terminal panel, which runs the real agent CLI, rather than "a new conversation" that does not exist there. Running a plain terminal is unchanged. -- **desktop app**: dropped the bar's own context-window meter and its restart nudge, front and back: a second, separately-tuned gauge beside the console's own Session meter (how much plan2code work this session has done) read as a duplicate of it, so there is now just the one, and it already points at New Session under the app (see above). The `agent_context` command, the Claude/Codex transcript readers behind it, and the context-nudge setting it read are removed from the Rust side too, not just unwired in the page. Every button that reconnects the console (after it stops, or after Update skills) is now labeled **Reconnect the console**, replacing the earlier mix of "Restart the console" and "Start it again" for the same action, and only one shows at a time. -- **desktop app**: the launch card's permission-mode tick is now **on by default** (checks off), matching the terminal's own default; untick it for an agent that keeps its normal approval prompts. -- **web console**: Help's "When an update is out" line now knows when it is read inside the app too: there, it names **Update skills** in the bar instead of describing the dashboard's UPDATE AVAILABLE banner and a terminal command, since that banner never shows under the app and the command has no terminal to run in. -- **desktop app**: the top bar's **Restart** button is now **New Session**, and every place the console names it under the app (the session meter, the dashboard's red-session banner, the finished-step guide, the Welcome tip, Help's Ask and Finishing topics, the handoff copy button's description) says so too; the meter's own advice under the app is a single **Start a New Session** button in the user's highlight color. Its confirmation no longer claims "What it was doing is not saved" (not always true). -- **desktop app**: with nothing saved yet, the terminal panel now starts docked right at a width that keeps the console's own side panels (such as Notes) from stacking under the main content, instead of the bottom dock it always opened with before; a saved choice from before is still kept exactly as it was. -- **desktop app**: the collapsed terminal panel's **Expand** button now reads **View Agent Terminal**, and docked right it reads top to bottom instead of running off the edge of the narrow strip. -- **desktop app**: the agent no longer prints the console's web address in the terminal panel, since the page is already in the window beside it: `terminalLine` under the app points at the dashboard instead, and the agent contract says to give no link there. -- **desktop app**: the console's "Not running... type **continue**" line makes **continue** a button under the app, which types `continue` and Enter (and, under Claude Code, its send-now chord) into the agent's terminal panel for you; the session meter's **Start a New Session** button presses the bar's own New Session (its confirmation included), replacing a "Press New Session at the top of the window" sentence now that the press works from there. -- **desktop app**: **New Session** now starts the fresh agent on a new console session, so the session meter starts over at green. Before, the fresh agent joined the window's old session, and the meter stayed red after the very press it asks for. The brief of where you were is still written from the old session first, and the old console shuts itself down once the window moves on. -- **web console**: the **Wrapping up** dialog after **Stop session** no longer closes itself when the stop lands: it turns into **Done**, with every step ticked, and stays up until you close it, so someone who stepped away comes back to an answer. Its "you can close the window/tab if you need to" line is gone. -- **web console**: a plan's **Build order** card has a **Combine phases** button beside **No changes**. One click fills the box with a request to merge phases where possible while keeping each to a clear concern. It shows only in Plan and Revise plan, where the breakdown is phases. -- **web console**: Help now reads right in the desktop app throughout, not just in the topics fixed before: what this page is and how long it runs, the troubleshooting table and its diagram, scroll memory, drafts, the session meter's red advice, Ask's "no agent" line and Privacy's link and address notes all name the app's window, its terminal panel, **New Session** and **Reconnect the console** instead of a browser tab, a link or a new conversation. The status line's approval hint says "the terminal panel" there too. In a browser, Help is unchanged. -- **desktop app**: the top bar's buttons now look like the console's own: rounded, quiet until hovered, then in your highlight color from User Preferences (the app keeps it for the next launch), with **New Session** outlined in it as the likely next step. -- **desktop app**: the New Session confirmation shows Planny, drawn like the console's own (outlined shell, star eye, smile), holding a steaming cup of coffee, and its buttons use the console's style: **New Session** in your highlight color, **Cancel** a plain button. The same highlight applies to the panel's other one-button prompts, such as **Retry** and **Reconnect the console**. -- **desktop app**: the top bar is rebuilt around two menus and one next step. The project shows as its folder name, with the full path and **Change project** in its menu; **New Session** always sits just left of the agent's menu, which carries a state dot, an amber **checks off** badge in place of the "Permission checks are off for ..." sentence, and **Change agent** once the agent has ended. The console's and the skills' messages share one slot at the right end that shows the most pressing step with its button (**Reconnect the console**, **Update skills**) and "+N more" for the rest, so the bar no longer overflows when several things go wrong at once. The repeated "Plan2Code" label, the full path, the "agent:" prefix and the long "Nothing starts until you press New Session" line are gone. -- **web console**: **User Preferences → Agents & models** is rebuilt as a master-detail split: the agent list stays pinned on the left and picking a row opens that agent's form in the pane beside it, so moving between agents no longer goes through a summary-to-form round trip. The same split carries the agent-less setup page (pick list left, state and way forward right). Behind it `agents-view.js` is split into a `screens/agents/` component set (data, list editor, summary, form) behind the unchanged `mountAgentsView` API, and the agent styles live in their own `styles/agents.css`. The setup page's starter templates are offered on the tab too, under **Or start from a template**: **Use this template** opens the new-agent form prefilled. Every capability is kept: per-form Save and Discard, the Unsaved prompt, Test, Delete, the 409 Save anyway path, and the setup states and templates. The Preferences dialog itself now follows the Card width pick, never wider than the wide preset (1080px), instead of a fixed 880px. +- **web console**: **User Preferences** is now four tabs (Appearance, Agents & models, System, Sounds & activities), **Agents & models** is a list beside a form for the picked agent, and **Highlight color** offers 38 colors. +- **web console**: reads right inside the desktop app. Advice that assumed a terminal (the session meter, the update banner, the finished-step guide, Help) points at the app's **New Session**, **Update skills** and **Reconnect the console** instead. +- **launcher**: `plan2code` asks whether to turn the agent's permission prompts off (Yes by default; `--keep-permissions` keeps them), and with no agent installed it prints each agent's install command and page before it exits. +- **docs**: all prose, help text, skill prompts and comments use US English spelling, and `npm test` checks it. ### 🐛 Fixed -- **custom agents**: on Windows, a custom agent whose installer added its folder to the user PATH is now offered by `plan2code` and the desktop app every time, not only from a terminal opened after the install. Both read the saved PATH as well as the one they inherited, and the agent starts with it too. -- **web console**: on the dashboard, canceling one spec's Delete and quickly opening another's no longer leaves **Delete it** doing nothing; the first dialog's late close cleared the second dialog's spec. -- **web console**: a handoff's **Copy** button keeps showing **Copied** (or **Copy was refused**) when the dashboard redraws while the clipboard answers, instead of the word landing on a button that was already replaced. -- **web console**: a finished screen's press (**Commit it now**, **Update CHANGELOG first**, **Back to the dashboard**, **Continue here**, a review) that nothing picks up, because the agent's turn ended while the screen waited, no longer says "Opening Changelog…" forever. After a minute of silence the line beside Planny says Plan2Code is not running and the choice is saved, with **continue** to type in the terminal (a button that types it there, under the app). -- **desktop app**: under Claude Code, the console's **continue** button also sends Claude Code's send-now chord (ctrl+x ctrl+s), so a `continue` it held as a queued message behind a stuck turn is delivered in one press instead of waiting in the terminal. -- **desktop app**: links that leave the console (**Open pull request**, links in documents, the feedback button) open in the default browser instead of doing nothing; when no browser can be started, the page shows the link with a **Copy** button to paste into one. -- **web console**: answers sent and not picked up bring up the "not running, type **continue**" help after a minute of the agent's silence (three when it said it was working), instead of after its quiet allowance, which a build can set to half an hour. -- **web console**: a failed Send says why: the lost-contact state and its reconnect help at once when the console is gone, the console's reason when it refuses the send, or that the console is still up and Send can be pressed again. -- **desktop app**: a test console started inside the app (for example by `cargo test` during a build) can no longer take over the window. Before, the window followed it, then fell back to an empty dashboard once the test shut it down, and the build's question sat on a page no one could see. The app now ignores any page whose session is not in its own console store. -- **desktop app**: a console too busy to answer a health check in time (a machine running a test suite) is given a second, longer look and then resumed on the same session. It is no longer swapped for a fresh, empty dashboard mid-build. -- **desktop app**: the Implementation Loop's end screen offers **Back to the dashboard** next to its other actions, on a finished loop and a stopped one, and it works with no agent running (it opens a fresh dashboard console session in the frame). The screen's status line also tells the truth now: it reads "Loop finished. Pick what happens next." (or "The loop stopped.") as your move instead of spinning "Starting Building + review…", so the taskbar dot goes green there instead of staying dark while the loop's finished page waits. +- **custom agents**: on Windows, an agent whose installer added its folder to the user PATH is offered right away, not only from a terminal opened after the install. +- **web console**: a finished screen's press that nothing picks up now says Plan2Code is not running and how to continue, a failed Send says why, and links that leave the console open in the default browser from the desktop app. +- **desktop app**: a test console started during a build can no longer take over the window, and a console too busy to answer a health check is no longer swapped for an empty dashboard mid-build. ## v2.11.1 diff --git a/docs/index.html b/docs/index.html index d0a9111..bbdb9e4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3,13 +3,14 @@ <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> -<title>Plan2Code: plan and build with your AI agent in your browser - +Plan2Code: plan and build with your AI agent + +