Commit graph

181 commits

Author SHA1 Message Date
a54a2f2875 feat(dashboard): logWorkAction and polishNoteAction
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 11:04:32 +02:00
1aaf31a4c5 refactor(ai): extract testable polish prompt, guard against empty input
- Extract prompt text into buildPolishPrompt() in polish-prompt.ts (no server-only),
  matching the pattern used by batch.ts/buildBatchPrompt and narrative.ts/buildNarrativePrompt
  so the prompt itself is unit testable.
- Add MAX_NOTE_LENGTH guard to truncate excessively long notes before polishing.
- Add early-return guard against empty input (non-retryable error).
- Run getProvider() and getSystemPrompt() concurrently via Promise.all().
- Document that polishNote() throws (foreground user-initiated action).

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 11:02:16 +02:00
3c8edeb946 feat(ai): single-shot note polishing for logged work entries
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:51:49 +02:00
5283a455fa fix(ai): exclude manual entries from card narratives, clarify summary panel wording
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:50:12 +02:00
08cf5d5ce7 fix(ai): never queue a logged entry for AI re-summarization
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:42:30 +02:00
a5b1c9ea2f fix(dashboard): match methodology's logged-hours figure to the KPI tile's rounding
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:41:10 +02:00
5d772ef672 feat(metrics): recompute reads manual entries, methodology states them
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:34:25 +02:00
47d19f9f38 fix(metrics): kpi caption honesty, manual-entry safety, extra coverage — Task 2 review findings
- Fix KPI row "Hours invested" caption to honestly show both session-derived and manually logged hours
- Add JSDoc warnings about manualMinutes being a discriminator (do not pass 0 for git commits)
- Extract isManual predicate to single source of truth, avoid triple derivation
- Add tests for mixed session+manual in same month and manual-only shape

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:32:40 +02:00
284385ca2b feat(metrics): fold manually logged minutes into project totals
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:25:04 +02:00
4d1e6cf412 fix(commits): set source on ingest/backfill writes, tidy Task 1 review findings
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:22:26 +02:00
65b09170af feat(commits): add source and manual_minutes fields
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-09-19 10:14:51 +02:00
1cb05f4689 docs(spec): Phase 7 — logged work entries
Design for letting the owner record off-repo work as a commits row
tagged source=manual, reusing every existing commit render path
(recent work, card history, activity/monthly aggregation) instead of
a parallel system, with a declared-hours figure added to the total
rather than session-clustered, and a small "Logged" tag distinguishing
it from a real commit everywhere it appears.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-19 08:10:55 +02:00
2d87cd505b chore(config): update .gitignore and enhance Next.js configuration
Added .superpowers directory to .gitignore to prevent tracking of specific Pocketbase data. Updated Next.js configuration to enable standalone output for optimized Docker image builds, reducing the need for the full node_modules tree.
2026-09-19 07:52:09 +02:00
616a6674c8 chore(plan): tighten timeline row geometry and label font
Uncommitted tweaks from the dashboard review pass: ROW_HEIGHT 36→40
gives row content a touch more headroom for two-line titles, BAR_HEIGHT
22→18 lets priority-coloured stripes feel deliberate rather than heavy,
MIN_WIDTH 0.06→0.10 widens the unscheduled-on-the-end fallback so a
card with only a target_date reads as a clear mark. Percent column
widened to fit three-digit figures.
2026-09-17 14:58:35 +02:00
4bc59316ce fix(dashboard): BarList duplicate key when items contain an 'other' row
parseCommitMessage emits type 'other' for unparseable subjects, so
metrics.byType can legitimately contain a row whose key is 'other'.
The fold-into-'other' code in BarList used the same string for the
synthesised bucket — two <li key="other"> siblings, React warns:

  Encountered two children with the same key, 'other'.

Reserve a key '__fold__' that cannot collide with raw input and display
'other' only at render time. The visible label stays the same.
2026-09-17 14:58:31 +02:00
4ce9b76874 feat(dashboard): add Refresh commits button, separate from Recompute
The single Recompute button conflated two ideas: re-aggregating the cached
metrics (instant, costs nothing) and pulling new commits from Forgejo
(slow, hits the external API). A user who clicked Recompute expecting
Recent Work to update was waiting on a metric that only depends on what
is already in the database.

Split the two actions:

* Refresh commits — wraps ingestProject(stopAfterKnownPages: 1), the
  same path as the hourly cron, scoped to one project. Snappy because
  it stops once a full page is already known.
* Recompute — unchanged behaviour. Re-aggregates the cached commits
  into the project_metrics row.

Both actions revalidate the dashboard, so Recent Work, head-line KPIs
and the 'Updated just now' indicator all stay consistent within a
single click.
2026-09-17 14:58:01 +02:00
d909a8bb34 feat(plan): redo the timeline as a proper Gantt chart
Replaces the row-packed bar layout with the slide-style Gantt the user
asked for: rows grouped by client, full date-range bars (start → target),
priority-coloured fills, a today marker, percent indicators, and
quarter/month header ticks. Single-day cards (no start_date set, which is
the entire existing dataset) get a MIN_WIDTH floor so they read as
substantial bars instead of zero-pixel dots.

Tray entry point and drop-zone wiring are unchanged: an empty tray
shows a quiet 'Every schedulable card is already on the timeline'
placeholder; dropping a block from the tray still calls the same
rescheduleCardAction.

When cards start carrying start_date as well as target_date the bars
will widen to the full date range automatically — the layout supports
real duration without further code.
2026-09-17 12:35:52 +02:00
0d4b62b0b4 fix(plan): pass ALL cards to RoadmapBuilder so dated bars survive
The Timeline tab was filtering cards to !targetDate before handing
them to RoadmapBuilder. The builder then computed its dated subset
from that pre-filtered list, so the timeline always received zero
dated cards regardless of what was in the database — the timeline
always rendered the empty-state hint even when the user had cards
dated weeks ago.

The bands view (Now/Next/Later) still does its own per-view filter
above the builder, so the builder receives the full set. Pass cards
through unfiltered and let the builder split them internally — the
tray gets the !targetDate subset, the timeline gets the rest.
2026-09-17 12:31:59 +02:00
2a57d29279 chore(dev): add dev:webpack script as a Turbopack fallback
The chunk.reason.enqueueModel crash tracked in vercel/next.js#92362 is
Turbopack-specific — the React flight client in react-server-dom-turbopack
exposes an enqueueModel method that react-server-dom-webpack does not. Run

> client-board@0.1.0 dev:webpack
> next dev --webpack

▲ Next.js 16.2.6 (webpack)
- Local:         http://localhost:3000
- Network:       http://192.168.1.162:3000
- Environments: .env.local
✓ Ready in 554ms
[?25h while the upstream issue is open if the overlay
keeps catching the crash in spite of the ThemeScript / hydration fixes.
2026-09-17 12:24:40 +02:00
17a4df5f80 feat(plan): timeline builder — drag unscheduled blocks onto the timeline
Replaces the static Timeline tab with a builder layout: an
Unscheduled tray on the left (grouped Inbox/Now/Next/Later) and the
existing timeline on the right. Drag a block from the tray onto the
timeline at the date you want it scheduled; drag a bar horizontally to
reschedule a card already on the timeline. Both paths route through
the same rescheduleCardAction so the activity log only ever shows one
date_changed entry.

TimelineView gains a drop zone (custom MIME so tray drops do not
collide with other text drags) and a vertical drop indicator that
follows the pointer while dragging. The empty-state hint replaces
the previous early return so users with only undated cards still see a
target to drag onto. The dated-bar drag-to-reschedule behaviour is
unchanged.
2026-09-17 12:23:32 +02:00
02adcb43ac fix(board): keep optimistic state authoritative so a single drop always lands
The previous handler called router.refresh() after every successful move
and the Board effect then adopted the new initialCards prop. Because
router.refresh() schedules the server re-render asynchronously, the new
initialCards could land AFTER setSaving(false) had already cleared busy.
The effect then ran with !busy and setCards(initialCards) reverted the
optimistic move — the card visibly snapped back to its origin column
on every single drag, even though the database had the move. The user
had to drag the card a second time to land it in the destination.

Trust the optimistic state for the lifetime of the Board instance.
The first mount still adopts the server snapshot via the useState
initializer. Concurrent moves from other clients appear on the next
page visit, which is acceptable for an owner-only kanban.

The useRefreshOnFocus hook still keeps a focus listener registered
while not busy, so a real cross-tab refresh still fires.
2026-09-17 12:15:34 +02:00
e7110c44ba fix(theme): no <script> in RSC, OS preference via CSS media query
The earlier 'use next/script beforeInteractive' attempt still emitted a
<script> tag inside React's renderer and therefore still tripped React
19's 'Encountered a script tag' warning on every page that used the root
layout, which is one of the documented triggers of the
chunk.reason.enqueueModel flight-client crash in
vercel/next.js#92362.

ThemeScript now returns null. The first paint picks the OS preference via
a @media (prefers-color-scheme: dark) block in globals.css so no flash
occurs for users on the default. An explicit stored choice is applied
synchronously by ThemeSync (a small client component) on mount — a
trade-off the shadcn dark-mode guide accepts too.

Also fixes the .light class selector the new media-query rule introduces.
2026-09-17 12:06:25 +02:00
a4774783a9 fix(dashboard): single template-literal child for <title> to stop SVG hydration mismatch
React 19's HTML serializer drops mixed text/expression children inside
<title> elements when emitting SVG markup, so the server rendered
<title></title> while the client rendered <title>2026-05-24: 0 commits</title>.
That mismatch was one of the documented triggers of the
chunk.reason.enqueueModel flight-client crash in
vercel/next.js#92362.

Pre-formatting the tooltip into a single string before passing it as the
<title>'s only child keeps server and client output identical.
2026-09-17 12:06:20 +02:00
950c3fb8ee fix(theme): use next/script beforeInteractive — <script> in RSC was breaking the flight client
Next.js 16 + React 19 reject <script> tags rendered from React
components: 'Encountered a script tag while rendering React component.
Scripts inside React components are never executed when rendering on the
client.' The error fires during RSC rendering for every page that uses
the root layout, which corrupts Turbopack's flight stream and surfaces
as 'chunk.reason.enqueueModel is not a function' on every navigation
(vercel/next.js#92362).

The dev-overlay recommendation to use <template> is misleading — that
won't execute a script. The supported App Router pattern is
<Script strategy="beforeInteractive"> from next/script, which inlines
the script in <head> before hydration. Theme behaviour is unchanged.
2026-09-17 11:22:40 +02:00
5c26f39f2c fix(nav): avoid Kanban flyout state update racing with RSC navigation
A click outside the Kanban sidebar flyout called setOpen(false) even when
the click was on a Link, so the deferred state update landed during the
Link navigation's RSC stream and corrupted Turbopack's flight client
(vercel/next.js#92362).

Skip the close when the click target is inside an <a> and flush the close
synchronously from the Link's own onClick so the state update completes
before navigation, not during RSC processing.
2026-09-17 11:15:32 +02:00
dc45063508 test(nav): prototype visibility and client scoping on the new home page 2026-09-17 10:42:52 +02:00
2cb745779a feat(nav): sidebar Kanban flyout, grouped by client 2026-09-17 10:42:50 +02:00
140703e0eb feat(projects): kind on create/admin, home page grouped by client 2026-09-17 10:42:48 +02:00
5dae0946eb feat(projects): add kind field (project | prototype) 2026-09-17 10:42:46 +02:00
5c986e6449 docs(spec): Phase 6 — client-grouped navigation and project kind
Design for grouping projects by client on the home page and in a new
sidebar Kanban flyout tree, making the dashboard the project landing
page with the board one click away, and a prototype/project kind flag
so unsolicited client-facing prototypes can live alongside committed
projects with the same permissions, just tagged differently.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-17 10:14:31 +02:00
6c41f4c662 fix(ai): raise max_tokens — inline reasoning was eating the whole budget
MiniMax M2.x reasons inside <think> tags in the normal content field, and
that reasoning is billed against max_tokens. At 4096 the heavier batches
spent the entire budget thinking, were truncated before writing a single
answer, and stripThinking correctly removed the unclosed block — leaving an
empty response.

The signature was distinctive: batches returned 25/25 or 0/25, never
anything partial. 193 of 779 commits went unsummarised with no error
anywhere. At 16384 the same 193 completed 8/8 batches with zero failures.

The interview's question call had the same bug at 1024, where it would have
returned an empty question and silently ended the interview on the first
turn. Now 8192.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 09:19:34 +02:00
226f8576f2 fix(board): pin the DndContext id to stop a hydration mismatch
dnd-kit derives the id of its accessibility description element from an
internal counter that starts fresh on the server and is already advanced on
the client. Every sortable card rendered aria-describedby="DndDescribedBy-0"
server-side and "DndDescribedBy-3" client-side, and React reported a
hydration mismatch across the whole board.

A stable id makes both sides agree.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 09:08:02 +02:00
8888acb2c6 fix(tests): stop the settings test destroying the configured API key
The test overwrote ai_api_key with a marker and then restored it to ""
rather than to its previous value, so every run of the integration suite
silently wiped the AI provider key. Symptom appears much later and looks
nothing like a test problem: AI features quietly stop working.

Captures the existing value first and restores it in a finally block, so a
failed assertion cannot leave the marker in place either. Deletes the
record instead when the test created it.

The suite runs against the shared instance — there is no separate test
database — so anything it touches, it must put back exactly.

feat(board): give the owner both a quick box and Plan with AI

The Phase 4 spec made the intake wizard client-facing only, reasoning that
the developer creates cards directly. That was wrong about how he wants to
work. The quick box stays the default for lines he already understands;
Plan with AI runs the same interview for work that is genuinely unformed.
Hidden entirely when no provider is configured.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 08:13:24 +02:00
7059105d78 fix(board): stop every successful drag from snapping back
The effect that syncs server state re-ran whenever `busy` flipped, which it
does at the end of every drag. It then called setCards(initialCards) with
the snapshot it already had — the server had not re-rendered — discarding
the optimistic move. The card visibly returned to its original column while
the database held the correct value.

Tracks the last adopted snapshot in a ref so the effect only acts on a
genuinely new one, and calls router.refresh() after a successful move so a
new snapshot actually arrives.

Also hardens the timeline drag: the pointerup handler compared against
`dragging` state, which updates asynchronously, so it could read the
pre-drag value and return early with the drag never committing and no error
anywhere. Reads a ref instead, and clears on pointercancel.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 08:08:10 +02:00
6afd419dd3 test(roadmap): reschedule auditing and role scoping 2026-09-17 07:19:54 +02:00
9a5f6ca3f7 feat(roadmap): planning page with bands, timeline and stats 2026-09-17 07:19:00 +02:00
ecf5f0c173 feat(roadmap): reschedule from the timeline, always audited 2026-09-17 07:18:20 +02:00
bed7af848e feat(roadmap): Gantt-style timeline with today marker and tracks 2026-09-17 07:17:58 +02:00
bc8cc9f776 feat(roadmap): Now/Next/Later view 2026-09-17 07:17:35 +02:00
6e231374e2 feat(roadmap): loader scoped by the caller's own read rules 2026-09-17 07:17:18 +02:00
b164f3273c feat(roadmap): checklist-derived completion percentage 2026-09-17 07:16:57 +02:00
1c24687dae feat(roadmap): time axis, month ticks and greedy row packing 2026-09-17 07:16:47 +02:00
0454abb853 feat(roadmap): Now/Next/Later derived from board order and dates 2026-09-17 07:16:24 +02:00
d88dc91d7d docs: Phase 5 spec and plan for the planning and roadmap view
Two views rather than one chart, because the data forced it: measured on
the live database, 1 of 5 live cards has a target date and none has both
dates. target_date is client-owned and optional; start_date is only set on
Inbox acceptance. A conventional Gantt would render almost empty.

So Now/Next/Later is the default and works with zero dates, and the
timeline earns its place as clients set dates. From Dave's Gantt reference
it takes the quarter header, the Today marker, project grouping with the
client's colour, and the per-row completion percentage — which maps onto
checklist progress, the one honest source for it. The faint full-width
track is load-bearing rather than decorative: it makes a sparse chart read
as unscheduled instead of broken.

Drag-to-reschedule always writes an activity row naming the owner, because
target_date belongs to the client. A developer silently moving a date the
client chose is the failure the activity log exists to prevent.

Completes the plan set for phases 1 through 5.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-17 07:14:47 +02:00
8a2fb46788 test(intake): server-decided fields and project scoping 2026-09-16 18:07:16 +02:00
5a9d1cb97f feat(card): show the intake brief and transcript 2026-09-16 18:05:42 +02:00
d5cf51c944 feat(intake): wizard on the board with a plain-box fallback 2026-09-16 18:05:20 +02:00
58be48a4b0 feat(intake): brief confirmation before submission 2026-09-16 18:04:53 +02:00
04e78aef6d feat(api): intake route creating an Inbox card from a brief 2026-09-16 18:04:44 +02:00
05ce52a6bf feat(schema): card brief, transcript and size band 2026-09-16 18:04:22 +02:00