noterai 0.1.0

package/packages/server/dist/persistence.d.ts

@@ -0,0 +1,42 @@
+import type { HumanNotes } from '../../shared/dist/index.js';
+export interface PersistedSettings {
+    activeSource?: string;
+    llmProvider?: string;
+    ollamaModel?: string;
+    genericLogPath?: string;
+    context7ApiKey?: string;
+    exaApiKey?: string;
+    lmStudioBaseUrl?: string;
+    lmStudioModel?: string;
+    customProviderName?: string;
+    customProviderBaseUrl?: string;
+    customProviderApiKey?: string;
+    customProviderModel?: string;
+}
+export interface BlueprintPersistedState {
+    phases: import('@noter/shared').SpecPhase[];
+    clarifications: import('@noter/shared').ClarificationQuestion[];
+    annotations: Record<string, string>;
+    updatedAt: number;
+}
+export interface PersistedState {
+    notes: HumanNotes | null;
+    settings: PersistedSettings;
+    deletedTaskIds: string[];
+    pinnedTaskIds: string[];
+    blueprint: BlueprintPersistedState | null;
+    suggestions: import('@noter/shared').TaskSuggestion[];
+}
+export declare function loadNotes(cwd?: string): HumanNotes | null;
+export declare function saveNotes(notes: HumanNotes, cwd?: string): void;
+export declare function loadSettings(cwd?: string): PersistedSettings;
+export declare function saveSettings(settings: PersistedSettings, cwd?: string): void;
+export declare function loadDeletedTaskIds(cwd?: string): string[];
+export declare function saveDeletedTaskIds(ids: string[], cwd?: string): void;
+export declare function loadPinnedTaskIds(cwd?: string): string[];
+export declare function savePinnedTaskIds(ids: string[], cwd?: string): void;
+export declare function loadSuggestions(cwd?: string): import('@noter/shared').TaskSuggestion[];
+export declare function saveSuggestions(suggestions: import('@noter/shared').TaskSuggestion[], cwd?: string): void;
+export declare function loadBlueprint(cwd?: string): BlueprintPersistedState | null;
+export declare function saveBlueprint(blueprint: BlueprintPersistedState, cwd?: string): void;
+//# sourceMappingURL=persistence.d.ts.map

package/packages/server/dist/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../src/persistence.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,OAAO,eAAe,EAAE,SAAS,EAAE,CAAC;IAC5C,cAAc,EAAE,OAAO,eAAe,EAAE,qBAAqB,EAAE,CAAC;IAChE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC1C,WAAW,EAAE,OAAO,eAAe,EAAE,cAAc,EAAE,CAAC;CACvD;AAkDD,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAEzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAI/D;AAID,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAE5D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAI5E;AAID,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpE;AAID,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAInE;AAID,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,eAAe,EAAE,cAAc,EAAE,CAEtF;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,OAAO,eAAe,EAAE,cAAc,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAIzG;AAID,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAE1E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAIpF"}

package/packages/server/dist/persistence.js

@@ -0,0 +1,103 @@
+/**
+ * Durable persistence for noter state (notes, settings, deleted suggestions).
+ * Writes JSON files to a `.noter/` directory in the repo root or CWD fallback.
+ * All I/O is synchronous on writes (rare, user-triggered) and async-safe on reads (startup).
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+const DIR_NAME = '.noter';
+const STATE_FILE = 'state.json';
+function getStateDir(cwd) {
+    const base = cwd || process.cwd();
+    return join(base, DIR_NAME);
+}
+function getStatePath(cwd) {
+    return join(getStateDir(cwd), STATE_FILE);
+}
+function ensureDir(cwd) {
+    const dir = getStateDir(cwd);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function readState(cwd) {
+    const path = getStatePath(cwd);
+    if (!existsSync(path)) {
+        return { notes: null, settings: {}, deletedTaskIds: [], pinnedTaskIds: [], blueprint: null, suggestions: [] };
+    }
+    try {
+        const raw = readFileSync(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return {
+            notes: parsed.notes ?? null,
+            settings: parsed.settings ?? {},
+            deletedTaskIds: parsed.deletedTaskIds ?? [],
+            pinnedTaskIds: parsed.pinnedTaskIds ?? [],
+            blueprint: parsed.blueprint ?? null,
+            suggestions: parsed.suggestions ?? [],
+        };
+    }
+    catch {
+        return { notes: null, settings: {}, deletedTaskIds: [], pinnedTaskIds: [], blueprint: null, suggestions: [] };
+    }
+}
+function writeState(state, cwd) {
+    ensureDir(cwd);
+    const path = getStatePath(cwd);
+    writeFileSync(path, JSON.stringify(state, null, 2), 'utf-8');
+}
+// --- Notes ---
+export function loadNotes(cwd) {
+    return readState(cwd).notes;
+}
+export function saveNotes(notes, cwd) {
+    const state = readState(cwd);
+    state.notes = notes;
+    writeState(state, cwd);
+}
+// --- Settings ---
+export function loadSettings(cwd) {
+    return readState(cwd).settings;
+}
+export function saveSettings(settings, cwd) {
+    const state = readState(cwd);
+    state.settings = settings;
+    writeState(state, cwd);
+}
+// --- Deleted suggestion IDs ---
+export function loadDeletedTaskIds(cwd) {
+    return readState(cwd).deletedTaskIds;
+}
+export function saveDeletedTaskIds(ids, cwd) {
+    const state = readState(cwd);
+    state.deletedTaskIds = ids;
+    writeState(state, cwd);
+}
+// --- Pinned task IDs ---
+export function loadPinnedTaskIds(cwd) {
+    return readState(cwd).pinnedTaskIds;
+}
+export function savePinnedTaskIds(ids, cwd) {
+    const state = readState(cwd);
+    state.pinnedTaskIds = ids;
+    writeState(state, cwd);
+}
+// --- Suggestions ---
+export function loadSuggestions(cwd) {
+    return readState(cwd).suggestions;
+}
+export function saveSuggestions(suggestions, cwd) {
+    const state = readState(cwd);
+    state.suggestions = suggestions;
+    writeState(state, cwd);
+}
+// --- Blueprint state ---
+export function loadBlueprint(cwd) {
+    return readState(cwd).blueprint;
+}
+export function saveBlueprint(blueprint, cwd) {
+    const state = readState(cwd);
+    state.blueprint = blueprint;
+    writeState(state, cwd);
+}
+//# sourceMappingURL=persistence.js.map

package/packages/server/dist/persistence.js.map

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

package/packages/server/dist/repoContext.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Repository context — detects git root, loads repo-level instructions,
+ * and matches active harness sessions by repository path.
+ *
+ * Used at CLI startup to make Noter repo-aware without requiring
+ * any manual configuration from the user.
+ */
+export interface RepoContext {
+    /** Current working directory where `noter` was launched */
+    cwd: string;
+    /** Resolved git repository root, or null if not in a git repo */
+    repoRoot: string | null;
+    /** Contents of AGENTS.md (preferred) or AGENT.md from repo root, or null */
+    repoInstructions: string | null;
+    /** Which instructions file was loaded, for logging */
+    instructionsFile: string | null;
+    /** Auto-attached session info for this repo, if found */
+    autoAttachedSession: AutoAttachedSession | null;
+}
+export interface AutoAttachedSession {
+    harness: string;
+    sessionId: string;
+    sessionPath: string;
+    repoPath: string;
+}
+/**
+ * Walk up from `startDir` looking for a `.git` directory or file.
+ * Returns the repo root path, or null if not inside a git repository.
+ */
+export declare function findGitRoot(startDir: string): string | null;
+/**
+ * Load AGENTS.md or AGENT.md from the repo root.
+ * AGENTS.md takes precedence if both exist.
+ */
+export declare function loadRepoInstructions(repoRoot: string): {
+    content: string | null;
+    file: string | null;
+};
+/**
+ * Try to find an active harness session that matches the given repo root.
+ *
+ * Matching strategies (by harness):
+ * - **Pi**: sessions dir is `~/.pi/agent/sessions/<escaped-workspace-dir>/`
+ * - **Factory Droid**: sessions dir is `~/.factory/sessions/<escaped-cwd>/`
+ * - **Claude Code**: no repo-path in directory structure — skip
+ * - **Codex**: no repo-path in directory structure — skip
+ *
+ * If multiple matching sessions exist, returns the most recently modified one.
+ */
+export declare function findMatchingSession(repoRoot: string): AutoAttachedSession | null;
+/**
+ * Resolve full repository context at startup.
+ * Non-blocking: if anything fails, returns partial context with nulls.
+ */
+export declare function resolveRepoContext(cwd: string): RepoContext;
+/**
+ * Format startup log messages for repo context.
+ */
+export declare function formatStartupLog(ctx: RepoContext): string[];
+//# sourceMappingURL=repoContext.d.ts.map

package/packages/server/dist/repoContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repoContext.d.ts","sourceRoot":"","sources":["../src/repoContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sDAAsD;IACtD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yDAAyD;IACzD,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0B3D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAuBtG;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAUhF;AA2DD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAqB3D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAqB3D"}

package/packages/server/dist/repoContext.js

@@ -0,0 +1,197 @@
+/**
+ * Repository context — detects git root, loads repo-level instructions,
+ * and matches active harness sessions by repository path.
+ *
+ * Used at CLI startup to make Noter repo-aware without requiring
+ * any manual configuration from the user.
+ */
+import { existsSync, readFileSync, statSync, readdirSync } from 'fs';
+import { join, basename, sep } from 'path';
+import { homedir } from 'os';
+/**
+ * Walk up from `startDir` looking for a `.git` directory or file.
+ * Returns the repo root path, or null if not inside a git repository.
+ */
+export function findGitRoot(startDir) {
+    let dir = startDir;
+    const root = sep === '/' ? '/' : `${String.fromCharCode(dir.charCodeAt(0) | 0x20)}:\\`;
+    while (true) {
+        const gitPath = join(dir, '.git');
+        if (existsSync(gitPath)) {
+            try {
+                const st = statSync(gitPath);
+                // .git can be a directory (normal repo) or a file (git worktree)
+                if (st.isDirectory() || st.isFile()) {
+                    return dir;
+                }
+            }
+            catch {
+                // Permission error — skip
+            }
+        }
+        if (dir === root)
+            break;
+        const parent = join(dir, '..');
+        if (parent === dir)
+            break; // filesystem root
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * Load AGENTS.md or AGENT.md from the repo root.
+ * AGENTS.md takes precedence if both exist.
+ */
+export function loadRepoInstructions(repoRoot) {
+    const agentsMd = join(repoRoot, 'AGENTS.md');
+    const agentMd = join(repoRoot, 'AGENT.md');
+    if (existsSync(agentsMd)) {
+        try {
+            const content = readFileSync(agentsMd, 'utf-8');
+            return { content, file: 'AGENTS.md' };
+        }
+        catch (err) {
+            console.error(`[repoContext] Warning: Could not read ${agentsMd}: ${err.message}`);
+        }
+    }
+    if (existsSync(agentMd)) {
+        try {
+            const content = readFileSync(agentMd, 'utf-8');
+            return { content, file: 'AGENT.md' };
+        }
+        catch (err) {
+            console.error(`[repoContext] Warning: Could not read ${agentMd}: ${err.message}`);
+        }
+    }
+    return { content: null, file: null };
+}
+/**
+ * Escape a path the same way Factory Droid does for its session directories.
+ * Factory Droid replaces `/` with `__` and `:` with `_` in directory names.
+ */
+function escapePathForFactoryDroid(filePath) {
+    return filePath.replace(/\//g, '__').replace(/:/g, '_');
+}
+/**
+ * Escape a path the same way Pi does for its session directories.
+ * Pi replaces `/` with `-` and `:` with `-` and ` ` with `-`.
+ */
+function escapePathForPi(filePath) {
+    return filePath.replace(/[/:\s]/g, '-');
+}
+/**
+ * Try to find an active harness session that matches the given repo root.
+ *
+ * Matching strategies (by harness):
+ * - **Pi**: sessions dir is `~/.pi/agent/sessions/<escaped-workspace-dir>/`
+ * - **Factory Droid**: sessions dir is `~/.factory/sessions/<escaped-cwd>/`
+ * - **Claude Code**: no repo-path in directory structure — skip
+ * - **Codex**: no repo-path in directory structure — skip
+ *
+ * If multiple matching sessions exist, returns the most recently modified one.
+ */
+export function findMatchingSession(repoRoot) {
+    // Try Factory Droid first (most likely harness for this project)
+    const droidSession = findDroidSession(repoRoot);
+    if (droidSession)
+        return droidSession;
+    // Try Pi
+    const piSession = findPiSession(repoRoot);
+    if (piSession)
+        return piSession;
+    return null;
+}
+function findDroidSession(repoRoot) {
+    const sessionsBase = process.env.FACTORY_SESSIONS_DIR ?? join(homedir(), '.factory', 'sessions');
+    const escapedDir = escapePathForFactoryDroid(repoRoot);
+    const harnessDir = join(sessionsBase, escapedDir);
+    return findMostRecentSessionInDir(harnessDir, 'factory-droid', repoRoot);
+}
+function findPiSession(repoRoot) {
+    const sessionsBase = process.env.PI_SESSION_DIR ?? join(homedir(), '.pi', 'agent', 'sessions');
+    const escapedDir = escapePathForPi(repoRoot);
+    const harnessDir = join(sessionsBase, escapedDir);
+    return findMostRecentSessionInDir(harnessDir, 'pi', repoRoot);
+}
+function findMostRecentSessionInDir(harnessDir, harness, repoRoot) {
+    if (!existsSync(harnessDir))
+        return null;
+    try {
+        const entries = readdirSync(harnessDir, { withFileTypes: true });
+        let mostRecent = null;
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.jsonl')) {
+                const filePath = join(harnessDir, entry.name);
+                try {
+                    const st = statSync(filePath);
+                    if (st.mtimeMs > (mostRecent?.mtime ?? 0)) {
+                        mostRecent = { path: filePath, mtime: st.mtimeMs };
+                    }
+                }
+                catch {
+                    // skip unreadable
+                }
+            }
+        }
+        if (mostRecent) {
+            const sessionId = basename(mostRecent.path, '.jsonl');
+            return {
+                harness,
+                sessionId,
+                sessionPath: mostRecent.path,
+                repoPath: repoRoot,
+            };
+        }
+    }
+    catch {
+        // permission or other FS error
+    }
+    return null;
+}
+/**
+ * Resolve full repository context at startup.
+ * Non-blocking: if anything fails, returns partial context with nulls.
+ */
+export function resolveRepoContext(cwd) {
+    const repoRoot = findGitRoot(cwd);
+    let repoInstructions = null;
+    let instructionsFile = null;
+    let autoAttachedSession = null;
+    if (repoRoot) {
+        const instrResult = loadRepoInstructions(repoRoot);
+        repoInstructions = instrResult.content;
+        instructionsFile = instrResult.file;
+        autoAttachedSession = findMatchingSession(repoRoot);
+    }
+    return {
+        cwd,
+        repoRoot,
+        repoInstructions,
+        instructionsFile,
+        autoAttachedSession,
+    };
+}
+/**
+ * Format startup log messages for repo context.
+ */
+export function formatStartupLog(ctx) {
+    const lines = [];
+    if (ctx.repoRoot) {
+        lines.push(`Running in repository: ${ctx.repoRoot}`);
+    }
+    else {
+        lines.push(`Not in a git repository; running from: ${ctx.cwd}`);
+    }
+    if (ctx.instructionsFile) {
+        lines.push(`Loaded ${ctx.instructionsFile} from repo root`);
+    }
+    if (ctx.autoAttachedSession) {
+        const { harness, sessionId } = ctx.autoAttachedSession;
+        lines.push(`Matched active ${harness === 'factory-droid' ? 'Factory Droid' : 'Pi'} session for this repo (${sessionId})`);
+    }
+    else if (ctx.repoRoot) {
+        lines.push(`No matching harness session found; starting unattached`);
+    }
+    return lines;
+}
+//# sourceMappingURL=repoContext.js.map

package/packages/server/dist/repoContext.js.map

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

package/packages/server/dist/routes/blueprint.d.ts

@@ -0,0 +1,7 @@
+import { Router } from 'express';
+import type { AppConfig } from '../config.js';
+export declare function context7SearchImpl(query: string, apiKey: string): Promise<string>;
+export declare function exaSearchImpl(query: string, apiKey: string): Promise<string>;
+export declare function buildGroundingTools(config: AppConfig): Record<string, any>;
+export declare function createBlueprintRouter(config: AppConfig): Router;
+//# sourceMappingURL=blueprint.d.ts.map

package/packages/server/dist/routes/blueprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blueprint.d.ts","sourceRoot":"","sources":["../../src/routes/blueprint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+B,MAAM,SAAS,CAAC;AAE9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAW9C,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BvF;AAID,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BlF;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAoC1E;AA6FD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CA2W/D"}