Repository navigation
Conversation
…16.0) - Trends: KPIs (average saved, savings rate, fastest-growing category, steadiest month), income/spending/savings bars, savings rate with a 3-month average and a note from the numbers, account balance sparklines, top categories × months as shaded tiles. No Chart.js; range label hidden. - AI Analysis: quick analyses with the mockup's labels (each sends an existing AI_PROMPTS question unchanged), your own question, an aria-live answer area, history (open again, export as Markdown), key pill. The request is byte-identical to v1.15.0's. - Settings: six tabs in the mockup's words with arrow keys; General, Import (folder card, files, import log), Accounts (order, names, starting balances), Credit cards (balance, limit, new APR and due day), Categories (delete moves transactions to Other), Data & reset (stored data, clean up with confirm, JSON export/import, start over). - Welcome: the Overview with no data; brand-only app bar on a true first run; "Try it with sample data" imports samples/ and your own files replace them. - New stored fields: State.cardDetails, State.sampleData. - Phone: the ☰ button shows × while the menu is open. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
In dark mode the most expensive months are the lightest tiles, so "Darker cells" was wrong there. "Stronger shades" is true in both themes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
At 390px the tab bar scrolls sideways, and every render started it at the left, so Credit cards, Categories and Data & reset were selected but off-screen. Each render now scrolls the selected tab into view. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
|
New commit At 390px the tab bar scrolls sideways, and every render reset it to the left. Credit cards, Categories and Data & reset were selected but off-screen. This was found while rebuilding #10 on top of this PR. It's a defect in this PR, so the fix goes on this branch.
🤖 Generated with Claude Code https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft Generated by Claude Code |
…ty redesign (#16-#21) Brings the Clarity redesign (#16 -> #17 -> #19 -> #20 -> #21, v1.12.0 to v1.16.0) into #10 so the Settings -> Database tab can be rebuilt on it. Conflicts in CHANGELOG.md, CLAUDE.md, README.md, index.html and js/views-settings.js were resolved by taking the redesign's version of each file. #10's changes to them (the 1.11.0 entry and version strings, the Database tab in SETTINGS_TABS, the unregistered-tab guard, README tips, CLAUDE.md notes) are rebuilt on the new design in the next commit. js/views-db.js merged cleanly: the redesign's file plus #10's db-tools view and DB Inspector re-read fix. Both are restyled next. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
…e-tab Merges cleanup-stale-docs-and-dead-code (#38), the top of the fix chain stacked on #21, so #10 can merge last. No rebase. Conflicts: - Versions: 1.17.0 kept in the footer, README, Settings -> General and CLAUDE.md §1. CHANGELOG: 1.17.0, then 1.16.15 ... 1.16.1, then 1.16.0. - CLAUDE.md: "Last updated" is #10's note followed by the chain's history; §3's views-db.js line names both the Database tab and the Changelog view that reads CHANGELOG.md. - views-db.js: #10's rebuilt DB Schema code, with #30's plan link note ({type,id}); the Changelog banner keeps "4. CHANGELOG" with #38's text and code (loadChangelog(), no embedded copy). - views-settings.js: #10's tab-bar comment and version line. - #10's wording about the embedded changelog, which #38 removed, is updated in CLAUDE.md §19 and the 1.17.0 entry. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
Carries master's v1.10.3-v1.10.5 up the stack: declined answers (#14), literal single "~" (#15) and the Import Logs race fix (#18). Conflicts: - js/views-ai.js: this branch rebuilt the AI tab around module state (aiPhase / aiPaint()), so #14's `respEl.innerHTML=aiRefusalHtml()` had nothing to write to. Ported it: a declined request sets aiPhase 'declined' and aiDeclined { question, category, explanation }; aiPaint() shows aiRefusalHtml() (now a Clarity warn callout) and "You asked". Nothing goes to history or Copy. send() and the request are #14's, unchanged. - CLAUDE.md §13: kept this branch's v1.16.0 bullets, added #15's single-"~" sentence and aiDeclined to the tab-state list; the "Last updated" line keeps 1.16.0 and adds the v1.10.3-v1.10.5 history. - CHANGELOG 1.16.0 (AI Analysis): one line on how declined questions show in the new answer area. Versions stay 1.16.0. - renderImportLog() keeps #18's guards; the Import tab's log already re-checks #impLog after the database read. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
…e-status-indicator Brings the Clarity redesign and fix stack (#16-#21, #24-#38, #10) into #23, so its backup status can be rebuilt on the app bar. All seven files #23 touched conflicted (CHANGELOG.md, CLAUDE.md, README.md, index.html, js/core.js, js/views-data.js, js/views-settings.js). Each was resolved by taking the redesign's version: the sidebar #23 built on is gone. The tree now equals settings-database-tab at 477f357. The next commit rebuilds #23's changes on the app bar's sync badge. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
…ights Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi # Conflicts: # CLAUDE.md # README.md # index.html # js/views-settings.js
…call it About Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi
|
Dark theme taken out of the stack (Luis, 2026-11-04). #17 is light only for now: no ◐ toggle, no Light / Dark / Match system setting, no dark tokens. It comes back later in its own PR. #17's change was merged forward into this branch (no force push).
🤖 Generated with Claude Code https://claude.ai/code/session_013Z8iBUZo6LRYpLthSp2PRi Generated by Claude Code |
Summary
The last part of the Clarity redesign: Trends, AI Analysis, all six Settings tabs and the first-run Welcome now match their mockups. Every number is computed from your data. The mockups name banks; the app still names none.
AI_MODEL,AI_MAX_TOKENS,AI_PROMPTS, the system prompt,buildFinancialSummary(), the<financial_data>wrapping andsend()/callClaude()raw mode are byte-identical. The tests compare each request body with one captured onclarity-plan.State.cardDetails(a card's APR and due day) andState.sampleData(the sample data is loaded). Both are saved, loaded and erased the proper way.What changed
Trends
Always your latest six months with data, across every account. As before, it ignores the date range and the accounts filter, so the shell now hides the range label here too (
NO_RANGE_VIEWS).balanceAt(), as on the Overview cards.generateInsights()removed).AI Analysis
AI_PROMPTSquestion unchanged;AI_QUICKmaps label → prompt. The label shown, and kept in history, is the new one.aria-live="polite", witharia-busywhile waiting. It shows "Claude is reading your summary…", then:renderMarkdown();model.Settings
role="tab"with arrow keys, Home and End (as on Forecast), plus arole="tabpanel".confirm()).exportAllData()/importJsonFile()existed, but no button called them.Welcome (first run)
shellHero()), so the page still has one H1. It has the hero buttons, three steps and three notes. The bank-specific step text is reworded bank-neutrally.pickDataFolder(), orreloadDataFiles()when a folder is connected.#filePick.samples/throughloadFiles(). It fetches the files over HTTP; opened as a file, it uses a picker (#samplePick).Phone (390px) vs MobileOverview / MobileMenu
New stored fields
cardDetails{ [cardId]: { apr, dueDay } }app_state(DB.loadAll()),finlens-state.json, JSON export/importsampleData(boolean)app_state,finlens-state.jsonaiHistory[].modelCLAUDE.md §4.1 and §20 are updated. The API key still never reaches the file: the tests check a captured state-file payload and the JSON export.
Other mockup differences
--t4(a Trends tile) is#5f62f0instead of the mockup's#6366f1, which gave white text only 4.47:1.Found, not fixed
importJsonFile()saves category rules and recurring choices undercategoryRules/recurringConfirmed, but they load fromcatRules/recurring.periodEndBalance()→currentBalances()). Trends usesbalanceAt(), so it isn't affected; the Overview still is.txOverrides[].link.idx).renderImportLog()and thedb-logsview are untouched here, so v1.10.5: fix Import Logs throwing when the view is left before it loads #18 still applies.accountLabels), display order, flag rules and transfer keywords.Not verified
file://: only the picker path was run. Thelocation.protocol === 'file:'branch itself was not.docs/EVAL.mdshould still hold.navigator.clipboardwas stubbed.support.jsis missing), so comparisons are by eye against their markup.Automated checks: earlier run, not re-run · commit not recorded
Moved unchanged from this PR's "Test results" comment on 2026-11-04; not re-run, so not in the new table format. Originally a description section titled "How it was tested".
The Playwright harness serves the pinned CDN libraries from npm. The bytes are identical, so the SRI hashes in
index.htmlverify:sri-check.jsloads marked and DOMPurify through theirintegrityattributes. Final run on the last commit:test-clarity.jstest-finances.jstest-plan.jstest-insights.js(new)boot.jsrace.jsrenderImportLogin the Import Logs view (views-data.js, the #18 bug), the same as onclarity-plan. None come from these screens. With #18's patch applied: 0.Checks changed in existing suites, and why:
test-clarity.js"Main nav visible, ☰ hidden at 1280px": it ran at boot with no data, which is now the first-run Welcome with a brand-only app bar. The check moved to right after the import. In its place, a new check asserts that the Welcome hides the nav and ☰. That is 54 → 55 checks.test-clarity.js"Settings tabs are plain text": the expected labels are now the mockup's (Credit cards,Data & reset).test-plan.js"Data & Reset: rows for forecast scenarios…": the regexes/Forecast scenarios/and/Investment mix/are now case-insensitive, because the rows read "Clear forecast scenarios" and "Clear investment mix".AI request identity:
capture-ai-base.jsran onclarity-plan. It sent all 8AI_PROMPTSquestions the wayaskAI(i)does, plus a custom question, withfetchstubbed in the page, and saved each body, header set and URL.test-insights.jsclicks each quick analysis and asks the same custom question on this branch. All 9 requests are byte-identical. The real API was never called.test-insights.js also covers:
pickDataFolder()/#filePick; sample data over HTTP and through the picker; Use my own files; own files replacing samples (257 rows, not 514).<img>/<script>stripped, truncated, no-text and 401 answers, history add / open / cap at 50 / clear, copy, save, export, the no-key prompt, the key never in the DOM.Screenshots: light, dark and 390px for Welcome, Trends, AI (no key, answer, cut off, no answer, thinking) and each Settings tab, plus the phone Overview and menu. I looked at each and compared it with the mockup markup.
Manual QA steps
Setup
git checkout clarity-insights.samples/checking_sample.csv,savings_sample.csvandcredit_card_sample.csvinto a scratch folder, e.g.Desktop\finlens-test. This PR changes import, clearing, JSON import and Start over, so never use your real folder.index.htmlfrom disk. Press F12 and keep the Console tab open.1. First-run Welcome
samples/folder and click Open.Expected:
2. Sample data is replaced, not merged
finlens-test, and allow edit access.Expected:
3. Trends
Expected:
4. AI Analysis without and with a key
Can I afford to save $1,500 a month?in Ask your own question and press Ctrl+Enter.Expected:
.mdfile.api.anthropic.com).finlens-ai-history-<date>.md.5. Settings: General and Import
savings_sample.csvto Other CSV, then back to Savings.Expected:
6. Settings: Accounts, Credit cards, Categories
Mainand press Tab.1500in its Starting balance, Apr 30 ($) field and press Tab.abcin the savings starting balance and press Tab.5000, then type a Current balance of1000(watch the bar), APR24.99and Payment due day40, then15.Petsand click Add category. Typepetsand press Enter.Expected:
abcgives "Enter an amount such as 1500.00." and the field is marked invalid.40gives "Enter a day from 1 to 31."petsgives "“pets” is already a category."Before this fix: deleting a category only removed the name from the list; transactions kept it.
7. Settings: Data & reset (clean up, export/import)
Expected:
finlens-export-<date>.json. Open it in Notepad: it hascardDetails, and no API key.8. Start over and the first run again
reset(lowercase). Then typeRESET.finlens-testin File Explorer.Expected:
RESETis typed exactly.finlens-testhasfinlens-state-backup-<date>.jsonand nofinlens-state.json. The CSVs are unchanged.9. Regression: other screens and narrow window
Expected:
Please check before merging
cardDetailsand shared with a linked debt.confirm()dialog.file://) in Chrome or Edge and try "Try it with sample data" (picker path), Pick your CSV folder, Reconnect and Save now with a real folder.masterafter v1.15.0: Clarity redesign, part 3 — Plan screens (Budget, Buckets, Debt, Investments, Forecast) #20 merges.https://claude.ai/code/session_013Z8iBXzUjiQbYziDZ8CZft
Generated by Claude Code