⏱️ Continuum Manual & Specification

1. Executive Overview & Philosophy

Continuum is a personal momentum and agile execution cockpit designed for thinkers, builders, and self-directed achievers. It synthesizes structured project execution (Kanban boards, time logging, documents) with habit mastery (daily routines, weekly rolling windows, and streak resilience).

Unlike rigid project management tools that separate long-term strategic projects from daily routines, Continuum binds them into a single coherent interface with zero context switching.

2. Workspace Organization: Personal Group & Projects

Continuum organizes work in a clean 3-level hierarchy: Workspace → Project Groups → Projects → Tasks.

• Personal Group: Built-in, protected root group with blue branding for individual tasks and standalone routines. Cannot be deleted.
• Custom Project Groups: Created for client work, learning tracks, companies, or life categories. Each has custom color palettes.
• Projects: Belong to a group and maintain their own Kanban boards, document repositories, and status tracking (active / archived).

3. Tasks & Kanban Board

Tasks live across 3 progressive Kanban columns:

• Not Started: Backlog and queued tasks.
• In Progress: Active tasks. Only one task may have a running stopwatch session at any given time.
• Done: Concluded tasks with historical time records.

Qualitative Scales

Configure custom scales in Settings for prioritizing work:

• Weight (Effort): Fibonacci (1, 2, 3, 5, 8, 13, 21), T-Shirt (XS, S, M, L, XL), or Linear.
• Importance (Value): Numeric (1 to 5) or Labeled Priority (Low, Medium, High, Critical).

Smart Auto-Naming

If a task title is left blank, Continuum automatically derives the title from the first sentence or heading of the description.

4. Live Stopwatch & Time Tracking

Continuum features non-intrusive, precise time tracking:

• Start / Pause: Click the play button on a task card to start the stopwatch.
• Navbar Stopwatch Widget: Displays the current running task, real-time timer, and instant pause / complete actions from any tab.
• Session History: Records timestamped start and end times for comprehensive reporting.
• Initial Time Reporting: When creating a task with status Done, users can record retroactive hours and minutes, which automatically aligns start and completion timestamps.

5. Project Documents & Specs Hub

Store project context alongside execution:

• Markdown Specs: Native markdown editor for requirements, architectural decisions, and meeting notes.
• External Links: Fast bookmarking for Google Docs, Figma files, GitHub repositories, or PRDs.

6. Period Productivity Reports

The Time Period Reports view provides time analysis filtered by preset ranges (Today, Yesterday, This Week, Last Week, This Month, Last Month, All Time):

• Boundary Overlap Precision: Sessions crossing midnight or period boundaries are accurately apportioned only to the elapsed seconds within the selected window.
• Metrics: Total logged hours, task count, and project distribution graphs.

7. Goals & Streaks Calendar Engine

The Goals extension provides autonomous habit tracking capable of optionally linking to Continuum projects.

Cadences & Allowances

• Daily Goals (DAILY): Measurable target (e.g. 30 mins). Includes a Rest Day Allowance (default 1 rest day per 7-day rolling window) so taking a day off does not break an active streak.
• Weekly Goals (WEEKLY): Target sessions per 7-day rolling cycle (e.g. 3 workouts per 7 days). Current active cycle allows partial progress without breaking.
• Milestone Goals (ONCE): One-off achievement with a hard target deadline date.

Four Calendar View Modes

• Month View: 7-column calendar (Mon-Sun) with quick + increment step and ✔ completion buttons.
• Week View: Horizontal daily agenda with detailed completion ratios, unit metrics, and session notes.
• Day View: Granular focus view with interactive progress sliders, stepper buttons, notes, and deadline countdowns.
• Year Heatmap View: 52-week annual contribution grid shaded by daily completion density with month-jump quick navigation.

Retroactive Logging Protection

Logging past dates triggers a confirmation alert warning that historical streaks will be recalculated, protecting user accountability with a "Don't warn me again" preference.

8. Data Portability: Backup & CSV Export

• Full JSON Backup: One-click export and import of all projects, groups, tasks, documents, and scale configurations.
• RFC 4180 CSV Export: Click Export CSV from the Goals toolbar to generate continuum_goals_export_YYYY-MM-DD.csv with 15 comprehensive columns covering goals metadata, active/longest streaks, and all historical check-in logs.

9. Keyboard Shortcuts Quick Reference

10. AI Agent & Browser Automation Protocol

Continuum is instrumented for programmatic inspection by AI coding assistants, autonomous test runners, and browser agents.

Runtime Global Specification

Open the browser developer console or execute in Puppeteer/Playwright:

// Inspect the active specification
console.log(window.__CONTINUUM_AGENT_SPEC__);

// Access registered DOM tools
const tools = window.__CONTINUUM_AGENT_SPEC__.domTools;
console.table(tools);

DOM Data Attributes

Interactive elements are annotated with data-tool and data-action attributes:

For machine-readable schema definitions, fetch /agent-spec.json.

11. Membership & Account Roles

Continuum adheres to the Forgeboro Foundry Actor Model, distinguishing three natural roles while keeping internal tier codes transparent:

• Visitors (Non-logged-in users): Non-logged-in users accessing Continuum locally on their device. All workspace boards, timers, notes, and streak tracking run with complete autonomy using private local browser storage. No data leaves your machine.
• Friends (Logged-in users): Users registered with a free Forgeboro Suite account. For Friends, Continuum operates as cloud-authoritative: tasks, projects, notes, and habit goals are kept synchronized directly in Cloud Firestore. Local storage is isolated to prevent leakage, and an account-scoped offline cache ensures seamless offline productivity. Running stopwatch clocks tick purely in memory and are saved to the cloud only when the task is paused or completed.
• Users (Paying customers): Customers subscribed to premium tiers, unlocking advanced team collaboration, cross-workspace integrations, and priority cloud services (reserved for future Forgeboro Suite features).