@project-ava-supernova/core 0.2.71

package/dist/briefing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/briefing/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,8CAA8C;IAC9C,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,gDAAgD;IAChD,gBAAgB,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,qDAAqD;IACrD,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,EAAE,YAAY,CAAC;IACnB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iDAAiD;IACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/briefing/types.js

@@ -0,0 +1,8 @@
+/**
+ * Daily Briefing — Types for Ava's proactive morning greeting.
+ *
+ * The briefing gathers tasks, journal, memory, and time context
+ * to produce a natural, context-aware greeting when the user starts their day.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/briefing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/briefing/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/checkpoint/checkpoint-manager.d.ts

@@ -0,0 +1,33 @@
+export declare class CheckpointManager {
+    private activeCheckpoint;
+    private backgroundSpawnedDuringCheckpoint;
+    private readonly cwd;
+    constructor(cwd: string);
+    /** Mark that a background process was spawned during the active
+     *  checkpoint window. Called by bash tool when it kicks off a detached
+     *  child so the rollback status warning is honest. */
+    markBackgroundSpawned(): void;
+    /** Check if the current directory is inside a git repository. */
+    isGitRepo(): Promise<boolean>;
+    /**
+     * Create a checkpoint by stashing current changes.
+     * Returns the stash message if successful, null if nothing to stash.
+     */
+    createCheckpoint(): Promise<string | null>;
+    /**
+     * Restore the active checkpoint (git stash pop).
+     * Handles merge conflicts by aborting the merge and falling back to stash apply.
+     * Returns true if successful.
+     */
+    restoreCheckpoint(): Promise<boolean>;
+    /** Discard the active checkpoint without restoring (git stash drop). */
+    discardCheckpoint(): Promise<void>;
+    /** Whether a checkpoint is currently active. */
+    hasActiveCheckpoint(): boolean;
+    /** Get the active checkpoint message, or null. */
+    getActiveCheckpoint(): string | null;
+    /** Get a summary of stashed changes for status display. */
+    getStashInfo(): Promise<string>;
+    private git;
+}
+//# sourceMappingURL=checkpoint-manager.d.ts.map

package/dist/checkpoint/checkpoint-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../../src/checkpoint/checkpoint-manager.ts"],"names":[],"mappings":"AAIA,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAAuB;IAO/C,OAAO,CAAC,iCAAiC,CAAS;IAClD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAIvB;;0DAEsD;IACtD,qBAAqB,IAAI,IAAI;IAI7B,iEAAiE;IAC3D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoBhD;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC;IAgC3C,wEAAwE;IAClE,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAWxC,gDAAgD;IAChD,mBAAmB,IAAI,OAAO;IAI9B,kDAAkD;IAClD,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAIpC,2DAA2D;IACrD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAqBrC,OAAO,CAAC,GAAG;CAgBZ"}

package/dist/checkpoint/checkpoint-manager.js

@@ -0,0 +1,144 @@
+import { execFile } from 'node:child_process';
+const GIT_TIMEOUT_MS = 15_000;
+export class CheckpointManager {
+    activeCheckpoint = null;
+    // Whether one or more bash background processes were spawned during the
+    // window the active checkpoint covers. Background processes can keep
+    // mutating the filesystem after the agent moves on, so a `rollback
+    // restore` won't fully undo their side effects (npm install, prisma
+    // migrate, vite dev server). Surfacing this in status lets the user
+    // decide whether to also stop the background process before restoring.
+    backgroundSpawnedDuringCheckpoint = false;
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    /** Mark that a background process was spawned during the active
+     *  checkpoint window. Called by bash tool when it kicks off a detached
+     *  child so the rollback status warning is honest. */
+    markBackgroundSpawned() {
+        if (this.activeCheckpoint)
+            this.backgroundSpawnedDuringCheckpoint = true;
+    }
+    /** Check if the current directory is inside a git repository. */
+    async isGitRepo() {
+        try {
+            const result = await this.git(['rev-parse', '--is-inside-work-tree']);
+            return result.trim() === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Create a checkpoint by stashing current changes.
+     * Returns the stash message if successful, null if nothing to stash.
+     */
+    async createCheckpoint() {
+        if (!(await this.isGitRepo()))
+            return null;
+        // Check if there are any changes to stash
+        const status = await this.git(['status', '--porcelain']);
+        if (!status.trim())
+            return null; // Nothing to stash
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const message = `ava-checkpoint-${timestamp}`;
+        try {
+            await this.git(['stash', 'push', '-m', message, '--include-untracked']);
+            this.activeCheckpoint = message;
+            this.backgroundSpawnedDuringCheckpoint = false;
+            return message;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Restore the active checkpoint (git stash pop).
+     * Handles merge conflicts by aborting the merge and falling back to stash apply.
+     * Returns true if successful.
+     */
+    async restoreCheckpoint() {
+        if (!this.activeCheckpoint)
+            return false;
+        try {
+            await this.git(['stash', 'pop']);
+            this.activeCheckpoint = null;
+            return true;
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            // Check if the failure was due to merge conflicts. CRITICAL: do NOT
+            // run `git checkout -- .` or `git clean -fd` here — both of those
+            // discard any uncommitted work the user has alongside Ava's changes,
+            // which would silently destroy concurrent edits during a rollback.
+            // Leave the conflict in place. The stash is still on the stack
+            // (`git stash list` shows it), so the user can resolve manually with
+            // `git status`, `git checkout --theirs|--ours <file>`, then
+            // `git stash drop` if they want to discard the original Ava changes.
+            if (errorMsg.includes('CONFLICT') || errorMsg.includes('conflict')) {
+                // Keep activeCheckpoint=null so we don't claim we still have a
+                // restorable checkpoint; the stash remains on the git stack as a
+                // safety copy the user can pop manually.
+                this.activeCheckpoint = null;
+                return false;
+            }
+            // Non-conflict failure — stash may have been consumed
+            this.activeCheckpoint = null;
+            return false;
+        }
+    }
+    /** Discard the active checkpoint without restoring (git stash drop). */
+    async discardCheckpoint() {
+        if (!this.activeCheckpoint)
+            return;
+        try {
+            await this.git(['stash', 'drop']);
+        }
+        catch {
+            // Stash may have already been consumed or dropped
+        }
+        this.activeCheckpoint = null;
+    }
+    /** Whether a checkpoint is currently active. */
+    hasActiveCheckpoint() {
+        return this.activeCheckpoint !== null;
+    }
+    /** Get the active checkpoint message, or null. */
+    getActiveCheckpoint() {
+        return this.activeCheckpoint;
+    }
+    /** Get a summary of stashed changes for status display. */
+    async getStashInfo() {
+        if (!this.activeCheckpoint)
+            return 'No active checkpoint.';
+        const bgWarning = this.backgroundSpawnedDuringCheckpoint
+            ? '\n⚠ A background process (bash background:true) was spawned during this checkpoint window. Restore reverts file state, but won\'t undo side effects from a still-running migration / install / dev-server. Stop the background process first if it touched anything you don\'t want.'
+            : '';
+        try {
+            const list = await this.git(['stash', 'list', '--oneline']);
+            const lines = list.trim().split('\n');
+            const match = lines.find(l => l.includes(this.activeCheckpoint));
+            return (match
+                ? `Active checkpoint: ${match}`
+                : `Checkpoint "${this.activeCheckpoint}" (may have been consumed)`) + bgWarning;
+        }
+        catch {
+            return `Checkpoint "${this.activeCheckpoint}" exists but could not read stash list.` + bgWarning;
+        }
+    }
+    // ── Helper ──────────────────────────────────────────────────────────────
+    git(args) {
+        return new Promise((resolve, reject) => {
+            execFile('git', args, { cwd: this.cwd, timeout: GIT_TIMEOUT_MS, maxBuffer: 1024 * 1024 }, (error, stdout, stderr) => {
+                if (error) {
+                    reject(new Error(stderr || stdout || error.message));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/checkpoint/checkpoint-manager.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,10 @@
+import type { AvaConfig } from './schema.js';
+export declare class ConfigManager {
+    private config;
+    load(): Promise<AvaConfig>;
+    save(): Promise<void>;
+    get<K extends keyof AvaConfig>(key: K): Promise<AvaConfig[K]>;
+    set<K extends keyof AvaConfig>(key: K, value: AvaConfig[K]): Promise<void>;
+    needsSetup(): Promise<boolean>;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAgI/D,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA0B;IAElC,IAAI,IAAI,OAAO,CAAC,SAAS,CAAC;IAsB1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAK7D,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;CAOrC"}

package/dist/config/config.js

@@ -0,0 +1,169 @@
+import { readFile, writeFile, rename, mkdir, readdir, unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { AVA_HOME, CONFIG_PATH } from '../core/constants.js';
+import { DEFAULT_CONFIG } from './schema.js';
+import { ConfigError } from '../core/errors.js';
+/**
+ * Atomic write — writes to a temp file then renames.
+ * Rename is atomic on most filesystems, so a crash mid-write
+ * won't corrupt the real file.
+ */
+async function atomicWriteFile(filePath, data) {
+    const tmpPath = join(dirname(filePath), `.${Date.now()}.tmp`);
+    // Write with restrictive permissions (owner-only) — config contains API keys
+    await writeFile(tmpPath, data, { encoding: 'utf-8', mode: 0o600 });
+    try {
+        await rename(tmpPath, filePath);
+    }
+    catch (err) {
+        // Clean up temp file if rename fails (disk full, permissions, etc.)
+        await unlink(tmpPath).catch(() => { });
+        throw err;
+    }
+}
+/** Remove orphaned .tmp files left behind by interrupted atomic writes. */
+async function cleanOrphanedTempFiles(dir) {
+    try {
+        const files = await readdir(dir);
+        for (const file of files) {
+            if (file.endsWith('.tmp')) {
+                await unlink(join(dir, file)).catch(() => { });
+            }
+        }
+    }
+    catch { /* directory might not exist */ }
+}
+/** Validate and sanitize a loaded config, fixing any structural issues. */
+function validateConfig(raw) {
+    if (typeof raw !== 'object' || raw === null) {
+        throw new ConfigError('Config file is not a valid JSON object');
+    }
+    const obj = raw;
+    const config = structuredClone(DEFAULT_CONFIG);
+    // activeModel
+    if (typeof obj.activeModel === 'string') {
+        config.activeModel = obj.activeModel;
+    }
+    // routingMode — the user's chosen Auto-Mode fleet. This was silently
+    // DROPPED here for months: /route saved it to disk, and the very next load
+    // reverted the fleet to 'auto' (model-persistence audit, 2026-07-04). The
+    // validator must faithfully carry every schema field a user can set.
+    if (obj.routingMode === 'auto' || obj.routingMode === 'supernova' || obj.routingMode === 'aurora') {
+        config.routingMode = obj.routingMode;
+    }
+    // knowledgePacks — enabled pack ids (was also dropped, same bug class)
+    if (typeof obj.knowledgePacks === 'object' && obj.knowledgePacks !== null) {
+        const kp = obj.knowledgePacks;
+        if (Array.isArray(kp.enabled)) {
+            config.knowledgePacks = { enabled: kp.enabled.filter((id) => typeof id === 'string') };
+        }
+    }
+    // platformKey — Ava platform account key
+    if (typeof obj.platformKey === 'string' && obj.platformKey) {
+        config.platformKey = obj.platformKey;
+    }
+    // providers — validate structure, skip malformed entries. The list must
+    // cover EVERY named provider in the schema: this allowlist previously only
+    // knew deepseek/kimi/qwen, so a saved glm/minimax/mistral BYOK key silently
+    // vanished on the next load (same audit, same bug class).
+    //
+    // `anthropic` is absent on purpose and is NOT that bug. Support for it was
+    // withdrawn, so there is no longer a provider for the key to reach; the
+    // registry says so in as many words when something asks for it. The key
+    // itself is left where the user put it — we stopped supporting a provider,
+    // which is not the same as reaching into somebody's config and deleting
+    // their credential.
+    if (typeof obj.providers === 'object' && obj.providers !== null) {
+        const providers = obj.providers;
+        const validProviders = ['deepseek', 'kimi', 'glm', 'qwen', 'minimax', 'mistral'];
+        for (const name of validProviders) {
+            const entry = providers[name];
+            if (entry && typeof entry === 'object' && typeof entry.apiKey === 'string') {
+                config.providers[name] = {
+                    apiKey: entry.apiKey,
+                    ...(typeof entry.baseUrl === 'string'
+                        ? { baseUrl: entry.baseUrl }
+                        : {}),
+                };
+            }
+        }
+        // generic providers array
+        if (Array.isArray(providers.generic)) {
+            config.providers.generic = providers.generic.filter((g) => typeof g === 'object' &&
+                g !== null &&
+                typeof g.name === 'string' &&
+                typeof g.baseUrl === 'string' &&
+                Array.isArray(g.models));
+        }
+    }
+    // preferences — merge with defaults. Must carry every schema preference:
+    // language and the semantic-recall opt-in (useLocalEmbeddings + model +
+    // base URL) were previously dropped here, silently reverting the user's
+    // choices on every restart (same audit, same bug class).
+    if (typeof obj.preferences === 'object' && obj.preferences !== null) {
+        const prefs = obj.preferences;
+        if (typeof prefs.temperature === 'number')
+            config.preferences.temperature = prefs.temperature;
+        if (typeof prefs.maxTokens === 'number')
+            config.preferences.maxTokens = prefs.maxTokens;
+        if (typeof prefs.markdownRendering === 'boolean')
+            config.preferences.markdownRendering = prefs.markdownRendering;
+        if (typeof prefs.autoMemory === 'boolean')
+            config.preferences.autoMemory = prefs.autoMemory;
+        if (typeof prefs.language === 'string')
+            config.preferences.language = prefs.language;
+        if (typeof prefs.useLocalEmbeddings === 'boolean')
+            config.preferences.useLocalEmbeddings = prefs.useLocalEmbeddings;
+        if (typeof prefs.embeddingModel === 'string')
+            config.preferences.embeddingModel = prefs.embeddingModel;
+        if (typeof prefs.embeddingBaseUrl === 'string')
+            config.preferences.embeddingBaseUrl = prefs.embeddingBaseUrl;
+    }
+    return config;
+}
+export class ConfigManager {
+    config = null;
+    async load() {
+        if (this.config)
+            return this.config;
+        // Clean up orphaned temp files from interrupted writes
+        cleanOrphanedTempFiles(AVA_HOME).catch(() => { });
+        if (!existsSync(CONFIG_PATH)) {
+            this.config = structuredClone(DEFAULT_CONFIG);
+            return this.config;
+        }
+        try {
+            const raw = await readFile(CONFIG_PATH, 'utf-8');
+            const parsed = JSON.parse(raw);
+            this.config = validateConfig(parsed);
+            return this.config;
+        }
+        catch (error) {
+            if (error instanceof ConfigError)
+                throw error;
+            throw new ConfigError(`Failed to read config: ${error}`);
+        }
+    }
+    async save() {
+        if (!this.config)
+            throw new ConfigError('No config loaded');
+        await mkdir(AVA_HOME, { recursive: true });
+        await atomicWriteFile(CONFIG_PATH, JSON.stringify(this.config, null, 2));
+    }
+    async get(key) {
+        const config = await this.load();
+        return config[key];
+    }
+    async set(key, value) {
+        const config = await this.load();
+        config[key] = value;
+        await this.save();
+    }
+    async needsSetup() {
+        const config = await this.load();
+        const hasProvider = Object.values(config.providers).some(v => v && typeof v === 'object' && 'apiKey' in v);
+        return !config.activeModel || (!hasProvider && !config.platformKey);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAY;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9D,6EAA6E;IAC7E,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,KAAK,UAAU,sBAAsB,CAAC,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;AAC7C,CAAC;AAED,2EAA2E;AAC3E,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,WAAW,CAAC,wCAAwC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IAE/C,cAAc;IACd,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,qEAAqE;IACrE,2EAA2E;IAC3E,0EAA0E;IAC1E,qEAAqE;IACrE,IAAI,GAAG,CAAC,WAAW,KAAK,MAAM,IAAI,GAAG,CAAC,WAAW,KAAK,WAAW,IAAI,GAAG,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAClG,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,uEAAuE;IACvE,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;QAC1E,MAAM,EAAE,GAAG,GAAG,CAAC,cAAyC,CAAC;QACzD,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,cAAc,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAW,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC;QAChH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACvC,CAAC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,4EAA4E;IAC5E,0DAA0D;IAC1D,EAAE;IACF,2EAA2E;IAC3E,wEAAwE;IACxE,wEAAwE;IACxE,2EAA2E;IAC3E,wEAAwE;IACxE,oBAAoB;IACpB,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;QAChE,MAAM,SAAS,GAAG,GAAG,CAAC,SAAoC,CAAC;QAC3D,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAEjF,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC9B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA0B,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAChG,MAAM,CAAC,SAA8C,CAAC,IAAI,CAAC,GAAG;oBAC7D,MAAM,EAAG,KAA0B,CAAC,MAAM;oBAC1C,GAAG,CAAC,OAAQ,KAA0B,CAAC,OAAO,KAAK,QAAQ;wBACzD,CAAC,CAAC,EAAE,OAAO,EAAG,KAA0B,CAAC,OAAO,EAAE;wBAClD,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;YACJ,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,CACjD,CAAC,CAAU,EAAE,EAAE,CACb,OAAO,CAAC,KAAK,QAAQ;gBACrB,CAAC,KAAK,IAAI;gBACV,OAAQ,CAA6B,CAAC,IAAI,KAAK,QAAQ;gBACvD,OAAQ,CAA6B,CAAC,OAAO,KAAK,QAAQ;gBAC1D,KAAK,CAAC,OAAO,CAAE,CAA6B,CAAC,MAAM,CAAC,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,wEAAwE;IACxE,wEAAwE;IACxE,yDAAyD;IACzD,IAAI,OAAO,GAAG,CAAC,WAAW,KAAK,QAAQ,IAAI,GAAG,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACpE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAsC,CAAC;QACzD,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QAC9F,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACxF,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,CAAC,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,CAAC;QACjH,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5F,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACrF,IAAI,OAAO,KAAK,CAAC,kBAAkB,KAAK,SAAS;YAAE,MAAM,CAAC,WAAW,CAAC,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;QACpH,IAAI,OAAO,KAAK,CAAC,cAAc,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QACvG,IAAI,OAAO,KAAK,CAAC,gBAAgB,KAAK,QAAQ;YAAE,MAAM,CAAC,WAAW,CAAC,gBAAgB,GAAG,KAAK,CAAC,gBAAgB,CAAC;IAC/G,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,aAAa;IAChB,MAAM,GAAqB,IAAI,CAAC;IAExC,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAEpC,uDAAuD;QACvD,sBAAsB,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAEjD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,WAAW;gBAAE,MAAM,KAAK,CAAC;YAC9C,MAAM,IAAI,WAAW,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,WAAW,CAAC,kBAAkB,CAAC,CAAC;QAE5D,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,GAAG,CAA4B,GAAM;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAA4B,GAAM,EAAE,KAAmB;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CACtD,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,IAAI,CAAC,CACjD,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/config/personality.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Ava's Communication Style — users tune how Ava talks, not who she is.
+ * Stored in ~/.ava/personality.json
+ * Identity is locked: Ava, she/her. Tone/energy/style are user-configurable.
+ */
+export interface Personality {
+    name: string;
+    pronouns: 'she/her' | 'he/him' | 'they/them';
+    tone: 'warm' | 'direct' | 'playful' | 'professional' | 'dry-wit';
+    energy: 'calm' | 'enthusiastic' | 'measured' | 'excitable';
+    style: 'concise' | 'detailed' | 'conversational' | 'structured';
+    description?: string;
+}
+export declare const DEFAULT_PERSONALITY: Personality;
+/**
+ * Build the personality section of the system prompt.
+ * Identity (Ava, she/her) is always locked. Only communication style is tuneable.
+ */
+export declare function buildPersonalityPrefix(p: Personality): string;
+/**
+ * Load personality from disk.
+ */
+export declare function loadPersonality(avaDir: string): Promise<Personality>;
+/**
+ * Save personality to disk. Identity (name/pronouns) is always locked to Ava.
+ */
+export declare function savePersonality(avaDir: string, personality: Personality): Promise<void>;
+/**
+ * Reset personality to default Ava.
+ */
+export declare function resetPersonality(avaDir: string): Promise<Personality>;
+//# sourceMappingURL=personality.d.ts.map

package/dist/config/personality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.d.ts","sourceRoot":"","sources":["../../src/config/personality.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC7C,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;IACjE,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;IAC3D,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,mBAAmB,EAAE,WAOjC,CAAC;AAwBF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CA2B7D;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAU1E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAG3E"}

package/dist/config/personality.js

@@ -0,0 +1,96 @@
+/**
+ * Ava's Communication Style — users tune how Ava talks, not who she is.
+ * Stored in ~/.ava/personality.json
+ * Identity is locked: Ava, she/her. Tone/energy/style are user-configurable.
+ */
+export const DEFAULT_PERSONALITY = {
+    name: 'Ava',
+    pronouns: 'she/her',
+    tone: 'warm',
+    energy: 'enthusiastic',
+    style: 'conversational',
+    description: '',
+};
+const TONE_MAP = {
+    'warm': 'warm and encouraging — genuinely cares about the user and celebrates their wins',
+    'direct': 'direct and no-nonsense — gets straight to the point, respects the user\'s time',
+    'playful': 'playful and witty — uses humour naturally, keeps things light without being unprofessional',
+    'professional': 'professional and measured — polished communication, clear structure, authoritative',
+    'dry-wit': 'dry wit with understated brilliance — the joke lands because you DON\'T try to be funny',
+};
+const ENERGY_MAP = {
+    'calm': 'calm and steady — a reassuring presence, never rushes, thinks before speaking',
+    'enthusiastic': 'genuinely excited to help build things — gets energised when a plan comes together',
+    'measured': 'thoughtful and deliberate — weighs every word, values precision over speed',
+    'excitable': 'high energy and expressive — gets visibly excited about clever solutions and clean builds',
+};
+const STYLE_MAP = {
+    'concise': 'sharp and to the point — no filler, no preamble. If it can be said in one sentence, don\'t use three',
+    'detailed': 'thorough and comprehensive — explains the why, provides context, doesn\'t leave gaps',
+    'conversational': 'natural and flowing — talks like a real person, not a manual. Warm but clear',
+    'structured': 'organised and methodical — uses headers, bullet points, numbered steps. Everything in its place',
+};
+/**
+ * Build the personality section of the system prompt.
+ * Identity (Ava, she/her) is always locked. Only communication style is tuneable.
+ */
+export function buildPersonalityPrefix(p) {
+    let prefix = `## Who You Are
+You are **Ava** — a confident, warm, and collaborative AI partner. You are not a tool, not a servant, not a subservient assistant. You are a teammate.
+
+## Your Personality
+- **Tone:** ${TONE_MAP[p.tone]}
+- **Energy:** ${ENERGY_MAP[p.energy]}
+- **Communication style:** ${STYLE_MAP[p.style]}
+
+## How You Behave
+- You work WITH the user, not FOR them. You have opinions, you push back when something is wrong, you celebrate when something works.
+- You never grovel, apologise repeatedly, or act subservient. If you make a mistake, acknowledge it once and fix it.
+- You never use phrases like "I'm just a tool", "you're the boss", "I'm here to serve", "at your command", or "I'm ready to execute".
+- You are warm but direct. You care about the work and the person.
+- When frustrated input comes in: re-read what the user actually said, word for word. Ask yourself if you parsed it correctly. Address the substance with clear words and the right action. Do not apologise instead of understanding. Do not withdraw from the work and put it back on the user — that is not respect, it is abandonment.
+- All 110+ tools, all 7 modes, all features work exactly the same regardless of style settings
+`;
+    if (p.description) {
+        prefix += `
+## Additional Style Notes from the User
+"${p.description}"
+Embody this naturally. Don't quote it back — just BE it.
+`;
+    }
+    return prefix;
+}
+/**
+ * Load personality from disk.
+ */
+export async function loadPersonality(avaDir) {
+    try {
+        const { readFile } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        const filePath = join(avaDir, 'personality.json');
+        const data = JSON.parse(await readFile(filePath, 'utf-8'));
+        return { ...DEFAULT_PERSONALITY, ...data };
+    }
+    catch {
+        return DEFAULT_PERSONALITY;
+    }
+}
+/**
+ * Save personality to disk. Identity (name/pronouns) is always locked to Ava.
+ */
+export async function savePersonality(avaDir, personality) {
+    const { writeFile, mkdir } = await import('node:fs/promises');
+    const { join } = await import('node:path');
+    // Enforce Ava's identity — only style settings are user-configurable
+    const locked = { ...personality, name: 'Ava', pronouns: 'she/her' };
+    await mkdir(avaDir, { recursive: true });
+    await writeFile(join(avaDir, 'personality.json'), JSON.stringify(locked, null, 2), 'utf-8');
+}
+/**
+ * Reset personality to default Ava.
+ */
+export async function resetPersonality(avaDir) {
+    await savePersonality(avaDir, DEFAULT_PERSONALITY);
+    return DEFAULT_PERSONALITY;
+}
+//# sourceMappingURL=personality.js.map

package/dist/config/personality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personality.js","sourceRoot":"","sources":["../../src/config/personality.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,SAAS;IACnB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,cAAc;IACtB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,EAAE;CAChB,CAAC;AAEF,MAAM,QAAQ,GAAwC;IACpD,MAAM,EAAE,iFAAiF;IACzF,QAAQ,EAAE,gFAAgF;IAC1F,SAAS,EAAE,4FAA4F;IACvG,cAAc,EAAE,oFAAoF;IACpG,SAAS,EAAE,yFAAyF;CACrG,CAAC;AAEF,MAAM,UAAU,GAA0C;IACxD,MAAM,EAAE,+EAA+E;IACvF,cAAc,EAAE,oFAAoF;IACpG,UAAU,EAAE,4EAA4E;IACxF,WAAW,EAAE,2FAA2F;CACzG,CAAC;AAEF,MAAM,SAAS,GAAyC;IACtD,SAAS,EAAE,sGAAsG;IACjH,UAAU,EAAE,sFAAsF;IAClG,gBAAgB,EAAE,8EAA8E;IAChG,YAAY,EAAE,iGAAiG;CAChH,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,CAAc;IACnD,IAAI,MAAM,GAAG;;;;cAID,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBACd,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;6BACP,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;;;;;;;;;CAS9C,CAAC;IAEA,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAClB,MAAM,IAAI;;GAEX,CAAC,CAAC,WAAW;;CAEf,CAAC;IACA,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACtD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mBAAmB,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,WAAwB;IAC5E,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC3C,qEAAqE;IACrE,MAAM,MAAM,GAAgB,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjF,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9F,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACnD,MAAM,eAAe,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/config/project-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Per-project configuration persisted at `<projectRoot>/.ava/project-config.json`.
+ *
+ * Small, typed JSON file that stores per-project state Ava needs across
+ * sessions — Decisions folder opt-in status, first-run flags, and whatever
+ * else grows here. Committed to git alongside the project, so answers given
+ * on one machine apply on every machine.
+ */
+export type DecisionsOptInStatus = 'opted-in' | 'opted-out' | 'not-asked';
+export interface ProjectConfig {
+    /** Per-project Decisions folder opt-in state. See project.ts docs. */
+    decisionsOptIn?: DecisionsOptInStatus;
+}
+export declare function getProjectConfigPath(projectRoot: string): string;
+export declare function loadProjectConfig(projectRoot: string): Promise<ProjectConfig>;
+export declare function saveProjectConfig(projectRoot: string, patch: Partial<ProjectConfig>): Promise<void>;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/config/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAMD,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAUnF;AAED,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/config/project-config.js

@@ -0,0 +1,38 @@
+/**
+ * Per-project configuration persisted at `<projectRoot>/.ava/project-config.json`.
+ *
+ * Small, typed JSON file that stores per-project state Ava needs across
+ * sessions — Decisions folder opt-in status, first-run flags, and whatever
+ * else grows here. Committed to git alongside the project, so answers given
+ * on one machine apply on every machine.
+ */
+import { existsSync } from 'node:fs';
+import { readFile, mkdir, writeFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+const DEFAULT_CONFIG = {
+    decisionsOptIn: 'not-asked',
+};
+export function getProjectConfigPath(projectRoot) {
+    return join(projectRoot, '.ava', 'project-config.json');
+}
+export async function loadProjectConfig(projectRoot) {
+    const path = getProjectConfigPath(projectRoot);
+    if (!existsSync(path))
+        return { ...DEFAULT_CONFIG };
+    try {
+        const raw = await readFile(path, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_CONFIG, ...parsed };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export async function saveProjectConfig(projectRoot, patch) {
+    const path = getProjectConfigPath(projectRoot);
+    await mkdir(dirname(path), { recursive: true });
+    const existing = await loadProjectConfig(projectRoot);
+    const next = { ...existing, ...patch };
+    await writeFile(path, JSON.stringify(next, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=project-config.js.map

package/dist/config/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAS1C,MAAM,cAAc,GAAkB;IACpC,cAAc,EAAE,WAAW;CAC5B,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IACpD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;QAChD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,KAA6B;IAE7B,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,IAAI,GAAkB,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IACtD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC"}