ctx-sync 1.0.0

package/dist/commands/list.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `ctx-sync list` command.
+ *
+ * Reads the encrypted state file, decrypts it, and lists all
+ * tracked projects with key metadata (name, path, branch, last accessed).
+ *
+ * @module commands/list
+ */
+import type { Command } from 'commander';
+import type { Project } from '@ctx-sync/shared';
+/** Result returned by executeList */
+export interface ListResult {
+    /** All tracked projects */
+    projects: Project[];
+}
+/**
+ * Execute the list command logic.
+ *
+ * 1. Load the private key.
+ * 2. Read and decrypt state.age.
+ * 3. Return the list of tracked projects.
+ *
+ * @returns List result with all tracked projects.
+ */
+export declare function executeList(): Promise<ListResult>;
+/**
+ * Format a project entry for display.
+ *
+ * @param project - The project to format.
+ * @param index - The index in the list (1-based for display).
+ * @returns Formatted string for console output.
+ */
+export declare function formatProject(project: Project, index: number): string;
+/**
+ * Register the `list` command on the given Commander program.
+ */
+export declare function registerListCommand(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAK3D,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,CAYvD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B1D"}

package/dist/commands/list.js

@@ -0,0 +1,84 @@
+/**
+ * `ctx-sync list` command.
+ *
+ * Reads the encrypted state file, decrypts it, and lists all
+ * tracked projects with key metadata (name, path, branch, last accessed).
+ *
+ * @module commands/list
+ */
+import { withErrorHandler } from '../utils/errors.js';
+import { loadKey } from '../core/key-store.js';
+import { readState } from '../core/state-manager.js';
+import { getConfigDir, getSyncDir } from './init.js';
+/**
+ * Execute the list command logic.
+ *
+ * 1. Load the private key.
+ * 2. Read and decrypt state.age.
+ * 3. Return the list of tracked projects.
+ *
+ * @returns List result with all tracked projects.
+ */
+export async function executeList() {
+    const configDir = getConfigDir();
+    const syncDir = getSyncDir();
+    const privateKey = loadKey(configDir);
+    const state = await readState(syncDir, privateKey, 'state');
+    if (!state || !state.projects || state.projects.length === 0) {
+        return { projects: [] };
+    }
+    return { projects: state.projects };
+}
+/**
+ * Format a project entry for display.
+ *
+ * @param project - The project to format.
+ * @param index - The index in the list (1-based for display).
+ * @returns Formatted string for console output.
+ */
+export function formatProject(project, index) {
+    const lines = [];
+    lines.push(`  ${index}. ${project.name}`);
+    lines.push(`     Path:     ${project.path}`);
+    lines.push(`     Branch:   ${project.git.branch}`);
+    if (project.git.hasUncommitted) {
+        lines.push('     Status:   uncommitted changes');
+    }
+    if (project.git.stashCount > 0) {
+        lines.push(`     Stashes:  ${project.git.stashCount}`);
+    }
+    const accessed = new Date(project.lastAccessed);
+    lines.push(`     Tracked:  ${accessed.toLocaleDateString()} ${accessed.toLocaleTimeString()}`);
+    return lines.join('\n');
+}
+/**
+ * Register the `list` command on the given Commander program.
+ */
+export function registerListCommand(program) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('List all tracked projects')
+        .action(withErrorHandler(async () => {
+        const result = await executeList();
+        if (result.projects.length === 0) {
+            console.log('No projects tracked.');
+            console.log('\nTrack your first project:');
+            console.log('  $ cd ~/projects/my-app');
+            console.log('  $ ctx-sync track');
+            return;
+        }
+        const chalk = (await import('chalk')).default;
+        console.log(chalk.bold(`Tracked projects (${result.projects.length}):\n`));
+        for (let i = 0; i < result.projects.length; i++) {
+            const project = result.projects[i];
+            if (project) {
+                console.log(formatProject(project, i + 1));
+            }
+            if (i < result.projects.length - 1) {
+                console.log('');
+            }
+        }
+    }));
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/note.d.ts

@@ -0,0 +1,151 @@
+/**
+ * `ctx-sync note <project>` command.
+ *
+ * Records and updates mental context for a project — the "23-minute
+ * problem" solution. Prompts the user for current task, blockers,
+ * next steps, related links, and breadcrumbs, then encrypts and
+ * stores them in `mental-context.age`.
+ *
+ * Supports both interactive (prompt-based) and non-interactive
+ * (flag-based) input modes. When updating, existing context is
+ * merged — not overwritten — so incremental notes accumulate.
+ *
+ * @module commands/note
+ */
+import type { Command } from 'commander';
+import type { ProjectMentalContext, RelatedLink } from '@ctx-sync/shared';
+/** Options for the note command */
+export interface NoteOptions {
+    /** The current task description */
+    task?: string;
+    /** Blockers (comma-separated or repeated flag) */
+    blockers?: string[];
+    /** Next steps (comma-separated or repeated flag) */
+    nextSteps?: string[];
+    /** Related links (comma-separated) */
+    links?: string[];
+    /** Breadcrumb note */
+    breadcrumb?: string;
+    /** File being worked on (format: file:line or file:line:col) */
+    file?: string;
+    /** Description of what's being done at the file location */
+    fileDescription?: string;
+    /** Non-interactive mode: skip prompts, use flags only */
+    noInteractive?: boolean;
+    /** Skip committing/pushing to sync repo */
+    noSync?: boolean;
+    /** Override prompt function (for testing) */
+    promptFn?: (existing: ProjectMentalContext | null) => Promise<NoteInput>;
+}
+/** Raw input collected from prompts or flags */
+export interface NoteInput {
+    currentTask?: string;
+    blockers?: string[];
+    nextSteps?: string[];
+    relatedLinks?: Array<{
+        title: string;
+        url: string;
+    }>;
+    breadcrumb?: string;
+    lastWorkingOn?: {
+        file: string;
+        line: number;
+        column?: number;
+        description: string;
+    };
+}
+/** Result of the note command */
+export interface NoteResult {
+    /** Name of the project */
+    projectName: string;
+    /** Whether a new mental context was created (vs. update) */
+    isNew: boolean;
+    /** The final merged mental context */
+    context: ProjectMentalContext;
+}
+/**
+ * Parse a file reference string into structured location data.
+ *
+ * Accepts formats:
+ *   - `file.ts`           → { file: 'file.ts', line: 0 }
+ *   - `file.ts:45`        → { file: 'file.ts', line: 45 }
+ *   - `file.ts:45:12`     → { file: 'file.ts', line: 45, column: 12 }
+ *
+ * @param fileRef - The file reference string.
+ * @returns Parsed location, or null if the string is empty.
+ */
+export declare function parseFileReference(fileRef: string): {
+    file: string;
+    line: number;
+    column?: number;
+} | null;
+/**
+ * Parse a link string into title and URL.
+ *
+ * Accepts formats:
+ *   - `https://example.com`            → { title: 'https://example.com', url: 'https://example.com' }
+ *   - `Title: https://example.com`     → { title: 'Title', url: 'https://example.com' }
+ *   - `Title - https://example.com`    → { title: 'Title', url: 'https://example.com' }
+ *
+ * @param linkStr - The link string.
+ * @returns Parsed link with title and URL.
+ */
+export declare function parseLink(linkStr: string): RelatedLink;
+/**
+ * Create a default empty mental context structure.
+ *
+ * @returns A blank ProjectMentalContext.
+ */
+export declare function createEmptyContext(): ProjectMentalContext;
+/**
+ * Merge new input into an existing mental context.
+ *
+ * Follows merge-not-overwrite semantics:
+ *   - `currentTask` is replaced if new input provides one.
+ *   - `lastWorkingOn` is replaced if new input provides one.
+ *   - Blockers, next steps, links, and breadcrumbs are appended.
+ *   - Duplicate blockers (by description) are skipped.
+ *   - Duplicate links (by URL) are skipped.
+ *
+ * @param existing - The existing mental context (or null for new).
+ * @param input - The new input to merge.
+ * @returns The merged context.
+ */
+export declare function mergeContext(existing: ProjectMentalContext | null, input: NoteInput): ProjectMentalContext;
+/**
+ * Collect note input from interactive prompts.
+ *
+ * Shows the user their existing mental context (if any) and prompts
+ * for updates. Empty responses keep the existing values.
+ *
+ * @param existing - The existing mental context (or null).
+ * @returns The collected input.
+ */
+export declare function collectNoteInput(existing: ProjectMentalContext | null): Promise<NoteInput>;
+/**
+ * Build NoteInput from CLI flags (non-interactive mode).
+ *
+ * @param options - The command-line options.
+ * @returns The constructed note input.
+ */
+export declare function buildInputFromFlags(options: NoteOptions): NoteInput;
+/**
+ * Execute the note command logic.
+ *
+ * 1. Load key and decrypt existing state to find the project.
+ * 2. Load existing mental context (if any).
+ * 3. Collect new input (interactive prompts or flags).
+ * 4. Merge new input into existing context.
+ * 5. Encrypt and write `mental-context.age`.
+ * 6. Optionally commit to the sync repo.
+ *
+ * @param projectName - The name of the project.
+ * @param options - Note command options.
+ * @returns The note result.
+ */
+export declare function executeNote(projectName: string, options?: NoteOptions): Promise<NoteResult>;
+/**
+ * Register the `note` command on the given Commander program.
+ */
+export declare function registerNoteCommand(program: Command): void;
+//# sourceMappingURL=note.d.ts.map

package/dist/commands/note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.d.ts","sourceRoot":"","sources":["../../src/commands/note.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAGV,oBAAoB,EACpB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAQ1B,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC1E;AAED,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiBxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAWtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CAQzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,GAAG,IAAI,EACrC,KAAK,EAAE,SAAS,GACf,oBAAoB,CA6EtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GACpC,OAAO,CAAC,SAAS,CAAC,CAgFpB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,CAoCnE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CA8ErB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0D1D"}