@sascha384/tic 1.35.0 → 2.0.1

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "tic",
   "description": "Issue tracking skills for Claude Code",
-  "version": "1.35.0",
+  "version": "2.0.1",
   "author": {
     "name": "Sascha Krug"
   },

package/README.md

@@ -1,15 +1,15 @@
 # tic
 
-A terminal UI for issue tracking, built for developers who live in the terminal. Track work items across multiple backends — local markdown files, GitHub Issues, GitLab Issues, Azure DevOps Work Items, and Jira.
+A terminal UI for issue tracking, built for developers who live in the terminal. Track work items across multiple backends — GitHub Issues, GitLab Issues, Azure DevOps Work Items, and Jira — with local SQLite storage.
 
 Built with TypeScript and [Ink](https://github.com/vadimdemedes/ink).
 
 ## Features
 
 - **Keyboard-driven TUI** — browse, create, edit, and manage work items without leaving the terminal
-- **Multiple backends** — local markdown, GitHub (via `gh`), GitLab (via `glab`), Azure DevOps (via `az`), Jira (via REST API)
+- **Multiple backends** — GitHub (via `gh`), GitLab (via `glab`), Azure DevOps (via `az`), Jira (via REST API)
 - **Automatic backend detection** — selects backend based on git remote, or configure manually
-- **Local markdown storage** — work items stored as markdown files with YAML frontmatter in a `.tic/` directory
+- **SQLite storage** — all data stored locally in `.tic/tic.db` with optional sync to remote backends
 - **CLI commands** — scriptable commands for all operations (`tic item list`, `tic item create`, etc.)
 - **Work item types** — organize by epic, issue, and task (configurable)
 - **Iterations** — group work into sprints or milestones
@@ -39,16 +39,18 @@ tic init           # Initialize (auto-detects backend from git remote)
 tic                # Launch the TUI
 ```
 
-For local storage, `tic init` creates a `.tic/` directory to store your work items. For GitHub, GitLab, or Azure DevOps projects, it detects the backend from the git remote automatically. You can also specify a backend explicitly:
+`tic init` creates a `.tic/` directory with a SQLite database to store your work items. For GitHub, GitLab, or Azure DevOps projects, it detects the backend from the git remote automatically. You can also specify a backend explicitly:
 
 ```bash
 tic init --backend github
 tic init --backend gitlab
 tic init --backend azure
 tic init --backend jira
-tic init --backend local
+tic init --backend none
 ```
 
+The TUI also auto-initializes on first run if no `.tic/` directory exists.
+
 ## Usage
 
 ### List View
@@ -123,70 +125,22 @@ Deleting an item automatically cleans up references — children have their pare
 
 ## Storage
 
-Work items live in `.tic/` at the root of your project:
+All data lives in `.tic/` at the root of your project:
 
 ```
 .tic/
-├── config.yml          # Types, statuses, iterations, settings
-├── items/
-│   ├── 1.md            # Work item #1
-│   ├── 2.md            # Work item #2
-│   └── ...
-├── templates/          # Work item templates
-│   └── bug-report.md   # Template with YAML frontmatter
-└── trash/              # Soft-deleted items (for undo)
+├── tic.db              # SQLite database (all items, config, undo log)
+└── items/              # Markdown mirrors (for sync / human-readable export)
+    ├── 1.md
+    ├── 2.md
+    └── ...
 ```
 
-Each item is a markdown file with YAML frontmatter:
-
-```markdown
----
-id: 1
-title: Implement user login
-type: task
-status: in-progress
-iteration: sprint-1
-priority: high
-assignee: alice
-labels: auth, backend
-parent: 3
-depends_on:
-  - 2
-created: 2026-01-15T10:00:00.000Z
-updated: 2026-01-20T14:30:00.000Z
----
-
-Full description of the work item goes here.
-
-## Comments
-
----
-author: alice
-date: 2026-01-18T09:00:00.000Z
-
-Decided to use JWT tokens for this.
-```
+The SQLite database (`.tic/tic.db`) is the single source of truth for work items, config, templates, and undo history. When a remote backend is configured, `SyncManager` also writes markdown mirrors to `.tic/items/` via `FilesBackend`.
 
-Configuration in `.tic/config.yml`:
-
-```yaml
-types:
-  - epic
-  - issue
-  - task
-statuses:
-  - backlog
-  - todo
-  - in-progress
-  - review
-  - done
-iterations:
-  - default
-current_iteration: default
-next_id: 1
-```
+Configuration (types, statuses, iterations, etc.) is stored in the `project_config` table and managed via the TUI settings screen or `tic config` CLI commands.
 
-You can edit these files directly — they're plain text. Customize types, statuses, and iterations by editing `config.yml`.
+If upgrading from a legacy `.tic/config.yml` setup, the database will automatically migrate the YAML config on first open.
 
 ## Claude Code Integration
 
@@ -240,7 +194,7 @@ Add `--json` to any command for machine-readable output, or `--quiet` to suppres
 
 | Backend | CLI Tool | Detection |
 |---------|----------|-----------|
-| Local markdown | — | Default fallback |
+| Local only (SQLite) | — | Default fallback |
 | GitHub Issues | [`gh`](https://cli.github.com/) | `github.com` in git remote |
 | GitLab Issues | [`glab`](https://gitlab.com/gitlab-org/cli) | `gitlab.com` in git remote |
 | Azure DevOps Work Items | [`az`](https://learn.microsoft.com/en-us/cli/azure/) | `dev.azure.com` or `visualstudio.com` in git remote |

package/dist/backends/availability.js

@@ -3,7 +3,8 @@ import { execFile } from 'node:child_process';
  * Maps each backend to the CLI binary it requires, or null if no CLI is needed.
  */
 export const BACKEND_CLI = {
-    local: null,
+    none: null,
+    filesystem: null,
     github: 'gh',
     gitlab: 'glab',
     azure: 'az',
@@ -29,7 +30,8 @@ export async function checkBackendAvailability(backend) {
  */
 export async function checkAllBackendAvailability() {
     const backends = [
-        'local',
+        'none',
+        'filesystem',
         'github',
         'gitlab',
         'azure',

package/dist/backends/availability.js.map

@@ -1 +1 @@
-{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/backends/availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuC;IAC7D,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,QAAQ,CACpB,MAAM,EACN,CAAC,WAAW,CAAC,EACb,EAAE,OAAO,EAAE,IAAI,EAAE,EACjB,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CACF,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAG/C,MAAM,QAAQ,GAAkB;QAC9B,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,wBAAwB,CAAC,CAAC,CAAC,CAAU,CAAC,CAC3E,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAiC,CAAC;AACrE,CAAC"}
+{"version":3,"file":"availability.js","sourceRoot":"","sources":["../../src/backends/availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAuC;IAC7D,IAAI,EAAE,IAAI;IACV,UAAU,EAAE,IAAI;IAChB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAoB;IAEpB,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,QAAQ,CACpB,MAAM,EACN,CAAC,WAAW,CAAC,EACb,EAAE,OAAO,EAAE,IAAI,EAAE,EACjB,CAAC,KAAK,EAAE,EAAE;YACR,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CACF,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAG/C,MAAM,QAAQ,GAAkB;QAC9B,MAAM;QACN,YAAY;QACZ,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,MAAM;KACP,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,wBAAwB,CAAC,CAAC,CAAC,CAAU,CAAC,CAC3E,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAiC,CAAC;AACrE,CAAC"}

package/dist/backends/factory.d.ts

@@ -1,12 +1,14 @@
 import type { Backend } from './types.js';
-import { LocalBackend } from './local/index.js';
+import type { SyncQueueAdapter } from '../sync/types.js';
 import { SyncManager } from '../sync/SyncManager.js';
-export declare const VALID_BACKENDS: readonly ["local", "github", "gitlab", "azure", "jira"];
+export declare const VALID_BACKENDS: readonly ["none", "filesystem", "github", "gitlab", "azure", "jira"];
 export type BackendType = (typeof VALID_BACKENDS)[number];
 export declare function detectBackend(root: string): BackendType;
 export declare function createBackend(root: string): Promise<Backend>;
+export declare function createRemoteBackend(root: string, backendType: string): Promise<Backend | null>;
 export interface BackendSetup {
-    backend: LocalBackend;
+    backend: Backend;
     syncManager: SyncManager | null;
+    queue: SyncQueueAdapter | null;
 }
 export declare function createBackendWithSync(root: string): Promise<BackendSetup>;

package/dist/backends/factory.js

@@ -1,10 +1,11 @@
 import { execSync } from 'node:child_process';
-import { LocalBackend } from './local/index.js';
+import { Storage } from '../storage/index.js';
+import { SyncQueue } from '../storage/syncQueue.js';
 import { configStore } from '../stores/configStore.js';
 import { SyncManager } from '../sync/SyncManager.js';
-import { SyncQueueStore } from '../sync/queue.js';
 export const VALID_BACKENDS = [
-    'local',
+    'none',
+    'filesystem',
     'github',
     'gitlab',
     'azure',
@@ -29,16 +30,24 @@ export function detectBackend(root) {
     catch {
         // Not a git repo or git not available
     }
-    return 'local';
+    return 'none';
 }
 export async function createBackend(root) {
+    const primary = Storage.create(root);
+    configStore.getState().setDatabase(primary.getDatabase());
     if (!configStore.getState().loaded) {
         await configStore.getState().init(root);
     }
-    const backend = configStore.getState().config.backend ?? 'local';
-    switch (backend) {
-        case 'local':
-            return LocalBackend.create(root);
+    return primary;
+}
+export async function createRemoteBackend(root, backendType) {
+    switch (backendType) {
+        case 'none':
+            return null;
+        case 'filesystem': {
+            const { FilesBackend } = await import('./files/index.js');
+            return new FilesBackend(root);
+        }
         case 'github': {
             const { GitHubBackend } = await import('./github/index.js');
             return new GitHubBackend(root);
@@ -56,47 +65,23 @@ export async function createBackend(root) {
             return JiraBackend.create(root);
         }
         default:
-            throw new Error(`Unknown backend "${backend}". Valid backends: ${VALID_BACKENDS.join(', ')}`);
+            return null;
     }
 }
 export async function createBackendWithSync(root) {
+    const primary = Storage.create(root);
+    configStore.getState().setDatabase(primary.getDatabase());
     if (!configStore.getState().loaded) {
         await configStore.getState().init(root);
     }
-    const backendType = configStore.getState().config.backend ?? 'local';
-    const local = await LocalBackend.create(root, {
-        tempIds: backendType !== 'local',
-    });
-    if (backendType === 'local') {
-        return { backend: local, syncManager: null };
-    }
-    let remote;
-    switch (backendType) {
-        case 'github': {
-            const { GitHubBackend } = await import('./github/index.js');
-            remote = new GitHubBackend(root);
-            break;
-        }
-        case 'gitlab': {
-            const { GitLabBackend } = await import('./gitlab/index.js');
-            remote = new GitLabBackend(root);
-            break;
-        }
-        case 'azure': {
-            const { AzureDevOpsBackend } = await import('./ado/index.js');
-            remote = new AzureDevOpsBackend(root);
-            break;
-        }
-        case 'jira': {
-            const { JiraBackend } = await import('./jira/index.js');
-            remote = await JiraBackend.create(root);
-            break;
-        }
-        default:
-            throw new Error(`Unknown backend "${backendType}". Valid backends: ${VALID_BACKENDS.join(', ')}`);
+    const config = configStore.getState().config;
+    const remote = await createRemoteBackend(root, config.backend ?? 'none');
+    let syncManager = null;
+    let queue = null;
+    if (remote) {
+        queue = new SyncQueue(primary.getDatabase());
+        syncManager = new SyncManager(primary, remote, queue);
     }
-    const queueStore = new SyncQueueStore(root);
-    const syncManager = new SyncManager(local, remote, queueStore);
-    return { backend: local, syncManager };
+    return { backend: primary, syncManager, queue };
 }
 //# sourceMappingURL=factory.js.map

package/dist/backends/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backends/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/backends/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,MAAM;CACE,CAAC;AAGX,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,EAAE;YACvC,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;QACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO,QAAQ,CAAC;QACnD,IACE,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC;YAChC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACpC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC;YAErC,OAAO,OAAO,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,WAAmB;IAEnB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;YAC1D,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC5D,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC5D,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC9D,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACxD,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAY;IAEZ,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1D,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC;IAEzE,IAAI,WAAW,GAAuB,IAAI,CAAC;IAC3C,IAAI,KAAK,GAA4B,IAAI,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7C,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC"}

package/dist/backends/files/hash.d.ts

@@ -0,0 +1 @@
+export declare function contentHash(content: string): string;

package/dist/backends/files/hash.js

@@ -0,0 +1,5 @@
+import { createHash } from 'node:crypto';
+export function contentHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/dist/backends/files/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/backends/files/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/backends/files/index.d.ts

@@ -0,0 +1,48 @@
+import { BaseBackend } from '../types.js';
+import type { BackendCapabilities, SyncableBackend } from '../types.js';
+import type { WorkItem, NewWorkItem, NewComment, Comment, Template } from '../../types.js';
+/**
+ * FilesBackend is a filesystem-based sync destination.
+ *
+ * It delegates all I/O to the existing local/items.ts and local/templates.ts
+ * modules. Unlike LocalBackend, it does NOT:
+ * - Cache items (caching is the primary backend's job)
+ * - Validate relationships (that's the primary backend's job)
+ * - Manage config (config lives in the primary/SQLite)
+ * - Manage next_id (IDs come from the primary)
+ * - Support soft-delete (that's a primary backend concept)
+ *
+ * It implements SyncableBackend so it can be used as a sync destination
+ * with ID-preserving imports via importWorkItem.
+ */
+export declare class FilesBackend extends BaseBackend implements SyncableBackend {
+    private root;
+    constructor(root: string);
+    getRoot(): string;
+    getCapabilities(): BackendCapabilities;
+    getStatuses(): Promise<string[]>;
+    getIterations(): Promise<string[]>;
+    getWorkItemTypes(): Promise<string[]>;
+    getAssignees(): Promise<string[]>;
+    getLabels(): Promise<string[]>;
+    getCurrentIteration(): Promise<string>;
+    setCurrentIteration(_name: string): Promise<void>;
+    listWorkItems(_iteration?: string): Promise<WorkItem[]>;
+    getWorkItem(id: string): Promise<WorkItem>;
+    createWorkItem(_data: NewWorkItem): Promise<WorkItem>;
+    updateWorkItem(id: string, data: Partial<WorkItem>): Promise<WorkItem>;
+    deleteWorkItem(id: string): Promise<void>;
+    /**
+     * Write a complete WorkItem preserving its existing ID.
+     * Used during sync to replicate items from primary to files.
+     */
+    importWorkItem(item: WorkItem): Promise<WorkItem>;
+    addComment(workItemId: string, comment: NewComment): Promise<Comment>;
+    getItemUrl(id: string): string;
+    openItem(_id: string): Promise<void>;
+    listTemplates(): Promise<Template[]>;
+    getTemplate(slug: string): Promise<Template>;
+    createTemplate(template: Template): Promise<Template>;
+    updateTemplate(oldSlug: string, template: Template): Promise<Template>;
+    deleteTemplate(slug: string): Promise<void>;
+}

package/dist/backends/files/index.js

@@ -0,0 +1,174 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { BaseBackend, UnsupportedOperationError } from '../types.js';
+import { readWorkItem, writeWorkItem, deleteWorkItem as removeWorkItemFile, listItemFiles, parseWorkItemFile, } from '../local/items.js';
+import { listTemplates as listTemplateFiles, readTemplate, writeTemplate, deleteTemplate as removeTemplateFile, slugifyTemplateName, } from '../local/templates.js';
+/**
+ * FilesBackend is a filesystem-based sync destination.
+ *
+ * It delegates all I/O to the existing local/items.ts and local/templates.ts
+ * modules. Unlike LocalBackend, it does NOT:
+ * - Cache items (caching is the primary backend's job)
+ * - Validate relationships (that's the primary backend's job)
+ * - Manage config (config lives in the primary/SQLite)
+ * - Manage next_id (IDs come from the primary)
+ * - Support soft-delete (that's a primary backend concept)
+ *
+ * It implements SyncableBackend so it can be used as a sync destination
+ * with ID-preserving imports via importWorkItem.
+ */
+export class FilesBackend extends BaseBackend {
+    root;
+    constructor(root) {
+        super(0); // no TTL cache
+        this.root = root;
+    }
+    getRoot() {
+        return this.root;
+    }
+    getCapabilities() {
+        return {
+            relationships: true,
+            customTypes: true,
+            customStatuses: true,
+            iterations: true,
+            comments: true,
+            fields: {
+                priority: true,
+                assignee: true,
+                labels: true,
+                parent: true,
+                dependsOn: true,
+            },
+            templates: true,
+            templateFields: {
+                type: true,
+                status: true,
+                priority: true,
+                assignee: true,
+                labels: true,
+                iteration: true,
+                parent: true,
+                dependsOn: true,
+                description: true,
+            },
+        };
+    }
+    // --- Metadata methods: return empty since metadata is the primary's concern ---
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getStatuses() {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getIterations() {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getWorkItemTypes() {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getAssignees() {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getLabels() {
+        return [];
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async getCurrentIteration() {
+        return '';
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async setCurrentIteration(_name) {
+        // no-op: iterations are managed by the primary backend
+    }
+    // --- Work item CRUD ---
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async listWorkItems(_iteration) {
+        const files = await listItemFiles(this.root);
+        const items = await Promise.all(files.map(async (f) => {
+            const raw = await fs.readFile(f, 'utf-8');
+            return parseWorkItemFile(raw);
+        }));
+        // No iteration filtering — that's the primary's job
+        return items;
+    }
+    async getWorkItem(id) {
+        return readWorkItem(this.root, id);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/require-await
+    async createWorkItem(_data) {
+        throw new UnsupportedOperationError('createWorkItem', 'FilesBackend');
+    }
+    async updateWorkItem(id, data) {
+        const existing = await this.getWorkItem(id);
+        const updated = {
+            ...existing,
+            ...data,
+            id, // preserve ID
+            updated: new Date().toISOString(),
+        };
+        await writeWorkItem(this.root, updated);
+        return updated;
+    }
+    async deleteWorkItem(id) {
+        await removeWorkItemFile(this.root, id);
+        // No relationship cleanup — that's the primary's job
+    }
+    /**
+     * Write a complete WorkItem preserving its existing ID.
+     * Used during sync to replicate items from primary to files.
+     */
+    async importWorkItem(item) {
+        await writeWorkItem(this.root, item);
+        return item;
+    }
+    // --- Comments ---
+    async addComment(workItemId, comment) {
+        const item = await this.getWorkItem(workItemId);
+        const newComment = {
+            author: comment.author,
+            date: new Date().toISOString(),
+            body: comment.body,
+        };
+        item.comments.push(newComment);
+        item.updated = new Date().toISOString();
+        await writeWorkItem(this.root, item);
+        return newComment;
+    }
+    // --- Item URL ---
+    getItemUrl(id) {
+        return path.resolve(this.root, '.tic', 'items', `${id}.md`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async openItem(_id) {
+        // no-op: FilesBackend is a sync destination, not interactive
+    }
+    // --- Templates ---
+    async listTemplates() {
+        return listTemplateFiles(this.root);
+    }
+    async getTemplate(slug) {
+        return readTemplate(this.root, slug);
+    }
+    async createTemplate(template) {
+        const slug = slugifyTemplateName(template.name);
+        const t = { ...template, slug };
+        await writeTemplate(this.root, t);
+        return t;
+    }
+    async updateTemplate(oldSlug, template) {
+        const newSlug = slugifyTemplateName(template.name);
+        if (oldSlug !== newSlug) {
+            await removeTemplateFile(this.root, oldSlug);
+        }
+        const t = { ...template, slug: newSlug };
+        await writeTemplate(this.root, t);
+        return t;
+    }
+    async deleteTemplate(slug) {
+        await removeTemplateFile(this.root, slug);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/backends/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backends/files/index.ts"],"names":[],"mappings":"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"}

package/dist/backends/files/sync.d.ts

@@ -0,0 +1,13 @@
+import type { TicDatabase } from '../../storage/db.js';
+/** Compute content hashes for all .tic/items/*.md files on disk. */
+export declare function computeFileHashes(root: string): Promise<Map<string, string>>;
+/** Detect which files changed, were added, or were deleted since last sync. */
+export declare function detectChanges(db: TicDatabase, root: string): Promise<{
+    changed: string[];
+    added: string[];
+    deleted: string[];
+}>;
+/** Update the stored hash for an item (upsert). */
+export declare function updateSyncState(db: TicDatabase, itemId: string, hash: string): void;
+/** Remove the stored hash for an item. */
+export declare function removeSyncState(db: TicDatabase, itemId: string): void;

package/dist/backends/files/sync.js

@@ -0,0 +1,69 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { eq } from 'drizzle-orm';
+import * as s from '../../storage/schema.js';
+import { listItemFiles } from '../local/items.js';
+import { contentHash } from './hash.js';
+/**
+ * Extract the item ID from a full file path like `/foo/.tic/items/42.md`.
+ */
+function idFromPath(filePath) {
+    return path.basename(filePath, '.md');
+}
+/** Compute content hashes for all .tic/items/*.md files on disk. */
+export async function computeFileHashes(root) {
+    const files = await listItemFiles(root);
+    const hashes = new Map();
+    for (const file of files) {
+        const id = idFromPath(file);
+        const raw = await fs.readFile(file, 'utf-8');
+        hashes.set(id, contentHash(raw));
+    }
+    return hashes;
+}
+/** Detect which files changed, were added, or were deleted since last sync. */
+export async function detectChanges(db, root) {
+    const currentHashes = await computeFileHashes(root);
+    // Get stored hashes from the file_sync_state table
+    const rows = db.select().from(s.fileSyncState).all();
+    const storedHashes = new Map();
+    for (const row of rows) {
+        storedHashes.set(row.itemId, row.hash);
+    }
+    const changed = [];
+    const added = [];
+    const deleted = [];
+    // Check current files against stored
+    for (const [id, hash] of currentHashes) {
+        const stored = storedHashes.get(id);
+        if (!stored) {
+            added.push(id);
+        }
+        else if (stored !== hash) {
+            changed.push(id);
+        }
+    }
+    // Check stored against current for deletions
+    for (const [id] of storedHashes) {
+        if (!currentHashes.has(id)) {
+            deleted.push(id);
+        }
+    }
+    return { changed, added, deleted };
+}
+/** Update the stored hash for an item (upsert). */
+export function updateSyncState(db, itemId, hash) {
+    const now = new Date().toISOString();
+    db.insert(s.fileSyncState)
+        .values({ itemId, hash, syncedAt: now })
+        .onConflictDoUpdate({
+        target: s.fileSyncState.itemId,
+        set: { hash, syncedAt: now },
+    })
+        .run();
+}
+/** Remove the stored hash for an item. */
+export function removeSyncState(db, itemId) {
+    db.delete(s.fileSyncState).where(eq(s.fileSyncState.itemId, itemId)).run();
+}
+//# sourceMappingURL=sync.js.map

package/dist/backends/files/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../../src/backends/files/sync.ts"],"names":[],"mappings":"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"}

package/dist/backends/jira/config.d.ts

@@ -3,4 +3,4 @@ export interface JiraConfig {
     project: string;
     boardId?: number;
 }
-export declare function readJiraConfig(root: string): Promise<JiraConfig>;
+export declare function readJiraConfig(_root: string): Promise<JiraConfig>;