@project-ava-supernova/core 0.2.71 → 0.2.73

package/dist/projects/project-data.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Where Ava's per-project data lives, and which project it belongs to.
+ *
+ * `~/.ava/projects/<hash>/` holds what Ava knows about a project — verification
+ * trust, brainstorm sessions — keyed by a hash of the project's path. Note what
+ * that is NOT: it is not where projects live. The user's code is wherever they
+ * made it. A row in the storage bar called "Projects" pointing here would say
+ * something false.
+ *
+ * Two things brought this module into being.
+ *
+ * The hash was implemented TWICE — `projectHash` in brainstorm-store.ts and
+ * `cwdHash` in verification-trust.ts — byte-identical and independently
+ * maintained. They agree today. If either drifted, the same project would
+ * silently split into two folders and Ava would lose her trust history and her
+ * brainstorming for it, with nothing failing loudly enough to notice.
+ *
+ * And the hash is ONE-WAY. Nothing recorded which path produced it, so Ava
+ * could never answer "which projects do I know about?" — you could only ask
+ * about a project you already had in your hand. `project.json` fixes that: the
+ * directory now says what it belongs to.
+ */
+import { projectsHomeFrom, DEFAULT_PROJECTS_DIRNAME } from './projects-home.js';
+export { projectsHomeFrom, DEFAULT_PROJECTS_DIRNAME };
+/** Ava's data root. */
+export declare function avaHome(): string;
+/**
+ * The folder new projects are created in.
+ *
+ * `~/Ava Projects` unless the user has pointed `preferences.projectsHome`
+ * somewhere else. Visible on purpose, and deliberately NOT under `~/.ava` —
+ * that is application data and it is hidden; source code in a dotfolder gets
+ * lost and gets skipped by backup tools.
+ *
+ * Resolved here rather than in each surface so the IDE, the extension and the
+ * CLI cannot disagree about where a project went. That is the mistake this
+ * module already exists to correct once.
+ */
+export declare function projectsHome(configured?: string | null): string;
+/**
+ * Stable id for a project path.
+ *
+ * Canonicalised first so a trailing slash or Windows drive-letter casing
+ * cannot produce separate buckets for one project.
+ */
+export declare function projectHash(projectPath: string): string;
+/** Directory holding Ava's data for one project. Does not create it. */
+export declare function projectDataDir(projectPath: string, globalDir?: string): string;
+/** What `project.json` records — the path the hash was made from. */
+export interface ProjectRecord {
+    version: 1;
+    /** Absolute path, as resolved when first seen. */
+    path: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+}
+/**
+ * Ensure the project's data directory exists and knows which project it is.
+ *
+ * Called by anything about to write per-project data. Cheap and idempotent:
+ * an existing record only has its `lastSeenAt` refreshed, so a project that
+ * moved keeps its original first-seen date rather than looking new.
+ */
+export declare function ensureProjectData(projectPath: string, globalDir?: string): Promise<string>;
+/**
+ * Every project Ava has data for, newest-seen first.
+ *
+ * Skips directories with no `project.json` — those predate this record and
+ * their path is genuinely unrecoverable, the hash being one-way. They are not
+ * an error; they are simply not listable.
+ */
+export declare function listKnownProjects(globalDir?: string): Promise<ProjectRecord[]>;
+//# sourceMappingURL=project-data.d.ts.map

package/dist/projects/project-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-data.d.ts","sourceRoot":"","sources":["../../src/projects/project-data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,CAAC;AAEtD,uBAAuB;AACvB,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBhG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoBpF"}

package/dist/projects/project-data.js

@@ -0,0 +1,126 @@
+/**
+ * Where Ava's per-project data lives, and which project it belongs to.
+ *
+ * `~/.ava/projects/<hash>/` holds what Ava knows about a project — verification
+ * trust, brainstorm sessions — keyed by a hash of the project's path. Note what
+ * that is NOT: it is not where projects live. The user's code is wherever they
+ * made it. A row in the storage bar called "Projects" pointing here would say
+ * something false.
+ *
+ * Two things brought this module into being.
+ *
+ * The hash was implemented TWICE — `projectHash` in brainstorm-store.ts and
+ * `cwdHash` in verification-trust.ts — byte-identical and independently
+ * maintained. They agree today. If either drifted, the same project would
+ * silently split into two folders and Ava would lose her trust history and her
+ * brainstorming for it, with nothing failing loudly enough to notice.
+ *
+ * And the hash is ONE-WAY. Nothing recorded which path produced it, so Ava
+ * could never answer "which projects do I know about?" — you could only ask
+ * about a project you already had in your hand. `project.json` fixes that: the
+ * directory now says what it belongs to.
+ */
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { mkdir, readFile, writeFile, readdir } from 'node:fs/promises';
+// The path rule itself lives in a dependency-free leaf, because the IDE
+// renderer needs the same answer and cannot import node:fs.
+import { projectsHomeFrom, DEFAULT_PROJECTS_DIRNAME } from './projects-home.js';
+export { projectsHomeFrom, DEFAULT_PROJECTS_DIRNAME };
+/** Ava's data root. */
+export function avaHome() {
+    return join(homedir(), '.ava');
+}
+/**
+ * The folder new projects are created in.
+ *
+ * `~/Ava Projects` unless the user has pointed `preferences.projectsHome`
+ * somewhere else. Visible on purpose, and deliberately NOT under `~/.ava` —
+ * that is application data and it is hidden; source code in a dotfolder gets
+ * lost and gets skipped by backup tools.
+ *
+ * Resolved here rather than in each surface so the IDE, the extension and the
+ * CLI cannot disagree about where a project went. That is the mistake this
+ * module already exists to correct once.
+ */
+export function projectsHome(configured) {
+    return projectsHomeFrom(homedir(), configured);
+}
+/**
+ * Stable id for a project path.
+ *
+ * Canonicalised first so a trailing slash or Windows drive-letter casing
+ * cannot produce separate buckets for one project.
+ */
+export function projectHash(projectPath) {
+    const canonical = resolve(projectPath).replace(/[\\/]+$/, '').toLowerCase();
+    return createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+}
+/** Directory holding Ava's data for one project. Does not create it. */
+export function projectDataDir(projectPath, globalDir) {
+    return join(globalDir ?? avaHome(), 'projects', projectHash(projectPath));
+}
+/**
+ * Ensure the project's data directory exists and knows which project it is.
+ *
+ * Called by anything about to write per-project data. Cheap and idempotent:
+ * an existing record only has its `lastSeenAt` refreshed, so a project that
+ * moved keeps its original first-seen date rather than looking new.
+ */
+export async function ensureProjectData(projectPath, globalDir) {
+    const dir = projectDataDir(projectPath, globalDir);
+    await mkdir(dir, { recursive: true });
+    const file = join(dir, 'project.json');
+    const now = new Date().toISOString();
+    let record = {
+        version: 1,
+        path: resolve(projectPath),
+        firstSeenAt: now,
+        lastSeenAt: now,
+    };
+    try {
+        const existing = JSON.parse(await readFile(file, 'utf8'));
+        if (existing?.firstSeenAt)
+            record = { ...record, firstSeenAt: existing.firstSeenAt };
+    }
+    catch { /* first time, or unreadable — rewrite it */ }
+    // Best-effort: failing to record the path must never stop the caller from
+    // doing the work it actually came here for.
+    try {
+        await writeFile(file, JSON.stringify(record, null, 2), 'utf8');
+    }
+    catch { /* ignore */ }
+    return dir;
+}
+/**
+ * Every project Ava has data for, newest-seen first.
+ *
+ * Skips directories with no `project.json` — those predate this record and
+ * their path is genuinely unrecoverable, the hash being one-way. They are not
+ * an error; they are simply not listable.
+ */
+export async function listKnownProjects(globalDir) {
+    const root = join(globalDir ?? avaHome(), 'projects');
+    let entries;
+    try {
+        entries = (await readdir(root, { withFileTypes: true }))
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const records = [];
+    for (const hash of entries) {
+        try {
+            const raw = await readFile(join(root, hash, 'project.json'), 'utf8');
+            const rec = JSON.parse(raw);
+            if (rec?.path)
+                records.push(rec);
+        }
+        catch { /* pre-record directory, or unreadable */ }
+    }
+    return records.sort((a, b) => (b.lastSeenAt ?? '').localeCompare(a.lastSeenAt ?? ''));
+}
+//# sourceMappingURL=project-data.js.map

package/dist/projects/project-data.js.map

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

package/dist/projects/projects-home.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Where new projects go — and nothing else.
+ *
+ * Dependency-free on purpose, like routing-modes.ts and the authoring format
+ * leaf. Four places need this answer and they do not share a runtime: core and
+ * the extension host are Node, the IDE renderer reaches the filesystem through
+ * Tauri, and the webviews have no filesystem at all. A file that imports
+ * nothing can be reached from all of them, so "where did Ava put my project?"
+ * has one answer instead of four that drift.
+ *
+ * The home directory is passed IN rather than read here, because that is the
+ * one thing each runtime discovers differently (`os.homedir()` in Node,
+ * `homeDir()` from Tauri in the renderer).
+ */
+/**
+ * The default folder name, under the user's home directory.
+ *
+ * Visible on purpose, and deliberately NOT under `~/.ava`: that is application
+ * data and it is hidden. Source code in a dotfolder is a trap — people lose
+ * it, and backup tools routinely skip dotfolders.
+ */
+export declare const DEFAULT_PROJECTS_DIRNAME = "Ava Projects";
+/**
+ * Resolve the projects home.
+ *
+ * `configured` is `preferences.projectsHome` — an absolute path the user chose.
+ * Empty or unset means the default. A default, not a prison: developers have
+ * settled habits about `~/dev` or `D:\work`, and the point is to remove a
+ * decision from someone who does not yet have one, not to overrule someone
+ * who does.
+ */
+export declare function projectsHomeFrom(homeDir: string, configured?: string | null): string;
+//# sourceMappingURL=projects-home.d.ts.map

package/dist/projects/projects-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-home.d.ts","sourceRoot":"","sources":["../../src/projects/projects-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAQvD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAIpF"}

package/dist/projects/projects-home.js

@@ -0,0 +1,43 @@
+/**
+ * Where new projects go — and nothing else.
+ *
+ * Dependency-free on purpose, like routing-modes.ts and the authoring format
+ * leaf. Four places need this answer and they do not share a runtime: core and
+ * the extension host are Node, the IDE renderer reaches the filesystem through
+ * Tauri, and the webviews have no filesystem at all. A file that imports
+ * nothing can be reached from all of them, so "where did Ava put my project?"
+ * has one answer instead of four that drift.
+ *
+ * The home directory is passed IN rather than read here, because that is the
+ * one thing each runtime discovers differently (`os.homedir()` in Node,
+ * `homeDir()` from Tauri in the renderer).
+ */
+/**
+ * The default folder name, under the user's home directory.
+ *
+ * Visible on purpose, and deliberately NOT under `~/.ava`: that is application
+ * data and it is hidden. Source code in a dotfolder is a trap — people lose
+ * it, and backup tools routinely skip dotfolders.
+ */
+export const DEFAULT_PROJECTS_DIRNAME = 'Ava Projects';
+/** Join two path segments without caring which separator the platform uses. */
+function joinPath(base, name) {
+    const sep = base.includes('\\') && !base.includes('/') ? '\\' : '/';
+    return base.replace(/[\\/]+$/, '') + sep + name;
+}
+/**
+ * Resolve the projects home.
+ *
+ * `configured` is `preferences.projectsHome` — an absolute path the user chose.
+ * Empty or unset means the default. A default, not a prison: developers have
+ * settled habits about `~/dev` or `D:\work`, and the point is to remove a
+ * decision from someone who does not yet have one, not to overrule someone
+ * who does.
+ */
+export function projectsHomeFrom(homeDir, configured) {
+    const trimmed = configured?.trim();
+    if (trimmed)
+        return trimmed.replace(/[\\/]+$/, '');
+    return joinPath(homeDir, DEFAULT_PROJECTS_DIRNAME);
+}
+//# sourceMappingURL=projects-home.js.map

package/dist/projects/projects-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects-home.js","sourceRoot":"","sources":["../../src/projects/projects-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,cAAc,CAAC;AAEvD,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;AAClD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,UAA0B;IAC1E,MAAM,OAAO,GAAG,UAAU,EAAE,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;AACrD,CAAC"}

package/dist/projects/storage-categories.d.ts

@@ -0,0 +1,45 @@
+/**
+ * What each thing in `~/.ava` counts as, and what the user is told it is.
+ *
+ * Dependency-free, and shared. The extension host and the IDE each carried
+ * their own copy of this map — same keys, same labels, same `categoryOf`,
+ * separately maintained. Adding one category to two files is how the two
+ * surfaces end up reporting a user's disk differently, which is a strange
+ * thing for a local-first product to do.
+ *
+ * The scanning itself stays per-surface: the host walks with `node:fs`, the
+ * IDE through Tauri. Only the rules live here.
+ */
+/** Which half of the bar a category belongs to. */
+export type StorageFamily = 'ava' | 'projects';
+export declare const CATEGORY_LABEL: Record<string, string>;
+/** Stable display order; largest-first is applied after, this breaks ties. */
+export declare const CATEGORY_ORDER: string[];
+/** Map a top-level entry name in `~/.ava` to a storage category. */
+export declare function categoryOf(name: string): string;
+/** What the user's projects folder costs. Measured separately from `~/.ava`,
+ *  because it is their work rather than Ava's footprint — and because it is
+ *  expensive enough that it cannot be measured on every render. */
+export interface ProjectsUsage {
+    /** The projects home this figure describes. */
+    path: string;
+    bytes: number;
+    /** ISO timestamp. Shown to the user, because a cached number that does not
+     *  say how old it is invites being read as live. */
+    measuredAt: string;
+    /** How many project folders were counted, when known. */
+    projectCount?: number;
+}
+/**
+ * Is a cached projects measurement worth reusing?
+ *
+ * A source tree is not a config folder — an Unreal project's `Intermediate`,
+ * `Binaries` and `DerivedDataCache` run to tens of gigabytes, and walking that
+ * on every page render would stall the UI every time. So the number is cached
+ * and shown with its age, and re-measured only on request or once it is stale.
+ */
+export declare const PROJECTS_USAGE_TTL_MS: number;
+export declare function isUsageStale(usage: ProjectsUsage | null | undefined, now?: number): boolean;
+/** "measured 2h ago" — deliberately coarse; the point is age, not precision. */
+export declare function measuredAgo(usage: ProjectsUsage | null | undefined, now?: number): string | null;
+//# sourceMappingURL=storage-categories.d.ts.map

package/dist/projects/storage-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-categories.d.ts","sourceRoot":"","sources":["../../src/projects/storage-categories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,UAAU,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcjD,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,cAAc,UAG1B,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED;;mEAEmE;AACnE,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd;wDACoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAAqB,CAAC;AAExD,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,OAAO,CAI/F;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI,CAUpG"}

package/dist/projects/storage-categories.js

@@ -0,0 +1,86 @@
+/**
+ * What each thing in `~/.ava` counts as, and what the user is told it is.
+ *
+ * Dependency-free, and shared. The extension host and the IDE each carried
+ * their own copy of this map — same keys, same labels, same `categoryOf`,
+ * separately maintained. Adding one category to two files is how the two
+ * surfaces end up reporting a user's disk differently, which is a strange
+ * thing for a local-first product to do.
+ *
+ * The scanning itself stays per-surface: the host walks with `node:fs`, the
+ * IDE through Tauri. Only the rules live here.
+ */
+export const CATEGORY_LABEL = {
+    models: 'Models',
+    runtime: 'Runtime',
+    creative: 'Creative',
+    memory: 'Memory',
+    journal: 'Journal',
+    datasets: 'Datasets',
+    // NOT "Projects". `~/.ava/projects/` holds what Ava knows ABOUT a project —
+    // trust state, brainstorm sessions — keyed by a hash of its path. The user's
+    // code is wherever they made it. A row called "Projects" reading 1 KB would
+    // say something false about where their work lives.
+    projects: 'Project data',
+    backups: 'Old backups',
+    other: 'Other',
+};
+/** Stable display order; largest-first is applied after, this breaks ties. */
+export const CATEGORY_ORDER = [
+    'models', 'runtime', 'creative', 'memory', 'journal',
+    'datasets', 'projects', 'backups', 'other',
+];
+/** Map a top-level entry name in `~/.ava` to a storage category. */
+export function categoryOf(name) {
+    const n = name.toLowerCase();
+    if (/backup/.test(n))
+        return 'backups';
+    if (n === 'models')
+        return 'models';
+    if (n === 'bin')
+        return 'runtime';
+    if (n === 'creative')
+        return 'creative';
+    if (n === 'memory' || n === 'memory.json' || n === 'memory.md' || n === 'embeddings' || n === 'graph.json')
+        return 'memory';
+    if (n === 'journal')
+        return 'journal';
+    if (n === 'datasets')
+        return 'datasets';
+    if (n === 'projects')
+        return 'projects';
+    return 'other';
+}
+/**
+ * Is a cached projects measurement worth reusing?
+ *
+ * A source tree is not a config folder — an Unreal project's `Intermediate`,
+ * `Binaries` and `DerivedDataCache` run to tens of gigabytes, and walking that
+ * on every page render would stall the UI every time. So the number is cached
+ * and shown with its age, and re-measured only on request or once it is stale.
+ */
+export const PROJECTS_USAGE_TTL_MS = 6 * 60 * 60 * 1000; // 6 hours
+export function isUsageStale(usage, now = Date.now()) {
+    if (!usage?.measuredAt)
+        return true;
+    const at = Date.parse(usage.measuredAt);
+    return Number.isNaN(at) || now - at > PROJECTS_USAGE_TTL_MS;
+}
+/** "measured 2h ago" — deliberately coarse; the point is age, not precision. */
+export function measuredAgo(usage, now = Date.now()) {
+    if (!usage?.measuredAt)
+        return null;
+    const at = Date.parse(usage.measuredAt);
+    if (Number.isNaN(at))
+        return null;
+    const mins = Math.max(0, Math.floor((now - at) / 60000));
+    if (mins < 1)
+        return 'just now';
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+//# sourceMappingURL=storage-categories.js.map

package/dist/projects/storage-categories.js.map

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

package/dist/social/index.d.ts

@@ -272,12 +272,27 @@ export interface Beat {
     /**
      * Does this story want SHOWING as well as saying?
      *
-     * The one genuinely per-story judgement about medium: a demo, a before/after
-     * or anything visual earns a video for Reels and Shorts; an argument or a
-     * position usually does not. This decides whether the video platforms are on
-     * by default, so the operator is not making that call five times a morning.
+     * The one genuinely per-story judgement about medium: would this land HARDER
+     * as a film than as text? Not only demos and before/afters — a mood piece, a
+     * piece to camera, a scene that sets a feeling. It decides whether the video
+     * platforms are on by default, so the operator is not making that call five
+     * times a morning.
+     *
+     * It used to be rationed, on the reasoning that "a video nobody needed costs
+     * them an hour". That was true when a usable clip took three to five attempts.
+     * A clip now comes back first-time in a couple of minutes, so the question is
+     * which form the idea WANTS, not whether it has earned the effort.
      */
     needs_video?: boolean;
+    /**
+     * The shape the idea wants, when the FORM is the idea rather than a wrapper
+     * on it — "30s piece to camera", "15s held shot of the dish", "silent 30s
+     * scene, caption carries it".
+     *
+     * Present only when a beat really exists in one form. Most angles work as
+     * either and should leave this alone.
+     */
+    format?: string;
 }
 /**
  * Surface-injected sink for the day's suggested beats. The web/hub

package/dist/social/index.d.ts.map

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

package/dist/tools/authoring/export-document.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Export a stored document to a chosen format.
+ *
+ * The Library is where documents are kept, exported and opened, and both the
+ * extension and the IDE mount that same tab. This module is the shared body
+ * behind both mounts: one place that decides what can be exported, what the
+ * output is called, and what a failure says. Two hosts calling one function is
+ * the only version of "one feature, two mounts" that does not quietly drift.
+ *
+ * Only sources we can faithfully re-render are exportable. A `.docx` is not
+ * offered as an `.odt` here, because that is a conversion with fidelity loss
+ * dressed up as an export — the honest answer for an already-built file is
+ * Open or Reveal, not a second lossy copy of it.
+ */
+import { type RenderTarget } from './export-formats.js';
+export interface ExportRequest {
+    /** Absolute path of the source document. */
+    sourcePath: string;
+    format: RenderTarget;
+    /** Absolute output path. Defaults to the source's name with a new extension. */
+    outPath?: string;
+    loadDocx?: () => Promise<unknown>;
+    loadPdf?: () => Promise<unknown>;
+}
+export type ExportResult = {
+    ok: true;
+    path: string;
+    bytes: number;
+} | {
+    ok: false;
+    error: string;
+};
+/** Where the export lands: beside its source, which is how `document_author
+ *  build` already behaves, so an exported file stays in the Library. */
+export declare function deriveExportPath(sourcePath: string, format: RenderTarget): string;
+export declare function exportDocument(req: ExportRequest): Promise<ExportResult>;
+/**
+ * RFC 4180 enough: quoted fields, doubled quotes, and — the case a
+ * split-on-newline parser gets wrong — newlines inside quoted fields.
+ */
+export declare function parseCsv(raw: string): {
+    headers: string[];
+    rows: string[][];
+};
+//# sourceMappingURL=export-document.d.ts.map

package/dist/tools/authoring/export-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-document.d.ts","sourceRoot":"","sources":["../../../src/tools/authoring/export-document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC;wEACwE;AACxE,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAOjF;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC9E;AAID;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CA8B7E"}