QuitForecast / The manual / The log and patterns

The log and patterns

The Log tab is where your own evidence accumulates. What was happening when cravings came, when they hit, who was around, and what all of it adds up to. None of it is a verdict on a place or a person. It is a record of what was true.

Logging a craving

Two taps and done. More than one thing can be true at once, because cravings are compound. Strength and company are optional questions. A one-press log from the widget, the wrist or Control Center files no number at all. The app never invents one you did not choose.

The full sheet asks four things: what was happening, when it hit, how strong it was, and who was around. Only the first needs an answer, and one tap gives it. More than one thing can be true, because real cravings are compound. Stress and a drink in hand can both be true, and logging both teaches the pair chart.

The quick routes file just the fact and the time. An unrated craving still counts everywhere counts are shown. It never votes on your strength average, because an average of ratings may only average ratings.

Logging one during an SOS session works too: when the wave clock runs out, the hub offers the log with one tap.

What weighs most

What was happening, ranked by how heavy the cravings were, weighted by strength, so the heavier one leads even when it came less often. The company card beside it counts who was around, in plain counts.

Ranking is by load, not by count. Something that came twice at full strength outranks something that came four times gently, because the heavier one deserves the top of your attention. The window it reads is your last thirty days.

Your top two carry a research-backed play each, cited like everything else. Something you named yourself gets the general if-then play; Other stays silent because it names nothing to plan for.

The company card answers the question the setup asked: who is usually around? It counts alone, with friends, with family, at work, in plain numbers from your own log. The morning note can compare what you predicted with what the log measured.

The week's shape

Cravings by weekday, drawn once eight are logged. The sentence above it names your heaviest day only when one day truly carries the week; an even week is shown, not claimed.

Seven bars, one per weekday, weighted the same way the ranked chart is. The gate is eight logged cravings. The headline sentence appears only when one day truly carries the week's weight; a flat week gets the chart and no claim.

A weekday pattern needs your last eight of that same weekday to speak, which takes real calendar time. The app would rather wait weeks than guess.

The craving window

Once your log holds enough evidence, the app names the two hours your cravings cluster in. It can check in just before them if you ask it to. It speaks in plain counts from your own log, never in odds.

The window is a two-hour stretch your cravings genuinely cluster in, found by reading your last thirty days. Its evidence sentence is a plain count you could verify by hand from your own log. It reads like this: seven of your last nine days had a craving between 8 and 10 PM. No percentages, no probabilities, no odds.

Before it opens, Today shows a window-soon card. If you opt in to check-ins, one notification arrives 45 minutes ahead. That is at most one per habit per day, and only on days the pattern still holds. There is never a heads-up about a window the app is not also willing to show you on screen.

If your log never clears the bar, no window ever appears, and the app says exactly that rather than inventing one. The window is the one feature that would rather not exist than fake existing.

Strength over time

Average craving strength, this week against the weeks before. Cravings getting weaker is the most motivating fact a log can hold, and this is where yours shows it.

The line is your average rated strength by week, drawn only from cravings you actually rated. Quick logs are excluded on purpose: counting an unrated tap as average strength would drag every real trend toward the middle.

The headline compares this week against your recent past and speaks only when there is enough rated data to compare. Cravings that arrive less often and land more softly: that is the shape most quits take. This chart is where your own version of that sentence becomes visible.

The quit-medicine record

If you use a patch, gum or another over-the-counter aid, the Log keeps your record of what you took and when you stepped down. It records, and it never advises.

Tell the app you are using a nicotine aid and it adjusts honestly. The nicotinic receptor reset curve holds at zero while nicotine is still arriving. It holds on Today, in the Habits sheet, on the Watch and on the widget, with a line saying why. The rest of the recovery keeps moving, because lungs and circulation do not wait for the patch to end.

The record itself is a diary: what you took, when, and when you stepped down, drawn as your own dated course. It never suggests a dose, never schedules a step-down, and never grades you; that conversation belongs to you and a pharmacist or doctor.