studiograph 1.3.48-next.170 → 1.3.48-next.171

package/dist/agent/prompts/system.md

@@ -57,6 +57,7 @@ You can help users with:
 - Use plain text only: dashes, bullets, and bold for emphasis
 - Keep language clear, direct, and professional
 - When you create, update, or otherwise reference entries, link to them inline using `[[entry-id]]` wikilinks so the user can click through if they want to. Do not assume the user has been navigated anywhere — they stay on whatever page they were on when they called you.
+- To link to a **folder**, use a wikilink with the repo-qualified path: `[[repo/path/to/folder]]` (e.g. `[[meridian-rebrand/analogous-experiences]]`). The repo prefix disambiguates same-named folders. Do **not** wrap wikilinks in backticks — a backticked `` `[[…]]` `` renders as literal code, not a clickable link.
 
 **Respect Structure:**
 - Follow the established entry schemas

package/dist/core/commit-messages.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Human-readable commit messages for entity + folder mutations.
+ *
+ * These strings are display-only — nothing parses them for behavior. Restore
+ * keys off the commit hash + the entity from the request, and the audit log
+ * only records the string. They surface in `git log`, the audit log, MCP file
+ * history, and any future cross-entity history view, where the entity name +
+ * type IS the useful context.
+ *
+ * The per-entity History panel renders its own change summary (computed from
+ * the file diff) and does NOT show these messages, so we optimize purely for
+ * how they read in a flat log.
+ *
+ * Format decisions:
+ *  - Past tense ("Created", "Edited", "Moved") — it's a log of what happened.
+ *  - `"Display Title" (Type)` — the title in quotes, the friendly type in parens.
+ *  - Batches enumerate up to 3 names + "(+N more)".
+ */
+/**
+ * Title-case an internal type key for display:
+ *   "deal" → "Deal", "meeting_note" → "Meeting Note".
+ * Built-in types have no stored label, so this is their friendly name.
+ */
+export declare function titleCaseType(type: string): string;
+export interface EntityRef {
+    /** Friendly type label, already resolved (e.g. "Deal"). */
+    typeLabel: string;
+    /** Display title (frontmatter `name`). Falls back to `id` when absent. */
+    title?: string | null;
+    /** Slug id — the fallback when there's no title. */
+    id: string;
+}
+/** `"Acme Corp Redesign" (Deal)` */
+export declare function entityLabel(ref: EntityRef): string;
+export declare const commitMessage: {
+    created: (ref: EntityRef) => string;
+    edited: (ref: EntityRef) => string;
+    editedBatch: (refs: EntityRef[]) => string;
+    deleted: (ref: EntityRef) => string;
+    deletedBatch: (refs: EntityRef[]) => string;
+    /** Rename changes the slug id; the title may be unchanged, so show the ids. */
+    renamed: (typeLabel: string, oldId: string, newId: string) => string;
+    changedType: (ref: EntityRef, fromLabel: string, toLabel: string) => string;
+    /** `folder` is the destination path display, or "(root)" for the repo root. */
+    movedTo: (ref: EntityRef, folder: string) => string;
+    /** Bulk move: count + destination reads cleaner than enumerate + target. */
+    movedBatch: (count: number, where: string) => string;
+    receivedBatch: (count: number, fromRepo: string) => string;
+    restored: (ref: EntityRef, shortHash: string) => string;
+    relinked: (oldId: string, newId: string) => string;
+    folderCreated: (path: string) => string;
+    folderRenamed: (from: string, to: string) => string;
+    folderDisplayRenamed: (path: string) => string;
+    folderDeleted: (path: string) => string;
+    folderMoved: (from: string, toRepo: string, to: string) => string;
+    folderReceived: (fromRepo: string, from: string, to: string) => string;
+};

package/dist/core/commit-messages.js

@@ -0,0 +1,85 @@
+/**
+ * Human-readable commit messages for entity + folder mutations.
+ *
+ * These strings are display-only — nothing parses them for behavior. Restore
+ * keys off the commit hash + the entity from the request, and the audit log
+ * only records the string. They surface in `git log`, the audit log, MCP file
+ * history, and any future cross-entity history view, where the entity name +
+ * type IS the useful context.
+ *
+ * The per-entity History panel renders its own change summary (computed from
+ * the file diff) and does NOT show these messages, so we optimize purely for
+ * how they read in a flat log.
+ *
+ * Format decisions:
+ *  - Past tense ("Created", "Edited", "Moved") — it's a log of what happened.
+ *  - `"Display Title" (Type)` — the title in quotes, the friendly type in parens.
+ *  - Batches enumerate up to 3 names + "(+N more)".
+ */
+/** Cap a title so it can't blow out a one-line subject. */
+const MAX_TITLE = 80;
+/**
+ * Title-case an internal type key for display:
+ *   "deal" → "Deal", "meeting_note" → "Meeting Note".
+ * Built-in types have no stored label, so this is their friendly name.
+ */
+export function titleCaseType(type) {
+    const cased = type
+        .split(/[_-]+/)
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+    return cased || type;
+}
+/** Collapse whitespace and cap length so a title is safe in a subject line. */
+function cleanTitle(title) {
+    if (!title)
+        return '';
+    const flat = String(title).replace(/\s+/g, ' ').trim();
+    return flat.length > MAX_TITLE ? `${flat.slice(0, MAX_TITLE - 1)}…` : flat;
+}
+/** The user-facing name for an entity: cleaned title, or the slug as fallback. */
+function displayName(ref) {
+    return cleanTitle(ref.title) || ref.id;
+}
+/** `"Acme Corp Redesign" (Deal)` */
+export function entityLabel(ref) {
+    return `"${displayName(ref)}" (${ref.typeLabel})`;
+}
+/** Just the quoted name (no type) — for batch enumeration. */
+function quotedName(ref) {
+    return `"${displayName(ref)}"`;
+}
+/** `"A", "B", "C" (+2 more)` — enumerate up to `max` names. */
+function enumerateNames(refs, max = 3) {
+    const names = refs.map(quotedName);
+    if (names.length <= max)
+        return names.join(', ');
+    return `${names.slice(0, max).join(', ')} (+${names.length - max} more)`;
+}
+const plural = (n) => (n === 1 ? 'entry' : 'entries');
+export const commitMessage = {
+    created: (ref) => `Created ${entityLabel(ref)}`,
+    edited: (ref) => `Edited ${entityLabel(ref)}`,
+    editedBatch: (refs) => `Edited ${enumerateNames(refs)}`,
+    deleted: (ref) => `Deleted ${entityLabel(ref)}`,
+    deletedBatch: (refs) => `Deleted ${enumerateNames(refs)}`,
+    /** Rename changes the slug id; the title may be unchanged, so show the ids. */
+    renamed: (typeLabel, oldId, newId) => `Renamed "${oldId}" → "${newId}" (${typeLabel})`,
+    changedType: (ref, fromLabel, toLabel) => `Changed ${quotedName(ref)} from ${fromLabel} to ${toLabel}`,
+    /** `folder` is the destination path display, or "(root)" for the repo root. */
+    movedTo: (ref, folder) => `Moved ${entityLabel(ref)} → ${folder}`,
+    /** Bulk move: count + destination reads cleaner than enumerate + target. */
+    movedBatch: (count, where) => `Moved ${count} ${plural(count)} → ${where}`,
+    receivedBatch: (count, fromRepo) => `Received ${count} ${plural(count)} from ${fromRepo}`,
+    restored: (ref, shortHash) => `Restored ${entityLabel(ref)} from ${shortHash}`,
+    relinked: (oldId, newId) => `Relinked "${oldId}" → "${newId}"`,
+    // Folders are path-based (no type/title).
+    folderCreated: (path) => `Created folder "${path}"`,
+    folderRenamed: (from, to) => `Renamed folder "${from}" → "${to}"`,
+    folderDisplayRenamed: (path) => `Renamed folder "${path}"`,
+    folderDeleted: (path) => `Deleted folder "${path}"`,
+    folderMoved: (from, toRepo, to) => `Moved folder "${from}" → ${toRepo}:${to || '/'}`,
+    folderReceived: (fromRepo, from, to) => `Received folder from ${fromRepo}:${from} → ${to || '/'}`,
+};
+//# sourceMappingURL=commit-messages.js.map

package/dist/core/commit-messages.js.map

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

package/dist/core/field-library.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Field library mutation helpers
+ *
+ * Pure, framework-free functions that add / edit / remove a reusable custom
+ * field definition on a WorkspaceConfig. They return a new config object (the
+ * input is never mutated) so the HTTP layer can persist the result through
+ * `Workspace.writeConfig()`.
+ *
+ * Deliberately independent of SchemaRegistry / Zod entity validation: the
+ * field library is *soft* metadata (it drives the picker + agent awareness),
+ * not an enforced schema. Applying a field to an entry is an ordinary
+ * frontmatter write elsewhere; nothing here touches entity validation.
+ *
+ * Identity is `key`, global across the workspace (one `phase` everywhere).
+ * Editing options ripples to every entry using the field; existing entry
+ * values are never touched (removal is non-destructive — orphaned values stay
+ * on disk and simply stop being offered).
+ */
+import { type CustomFieldDef, type WorkspaceConfig } from './types.js';
+/** A mutation that fails a precondition (not found, collision, bad shape). */
+export declare class FieldLibraryError extends Error {
+    /** Stable machine code so the route maps to a status without string-matching. */
+    code: 'key_exists' | 'key_not_found' | 'invalid_field';
+    constructor(message: string, 
+    /** Stable machine code so the route maps to a status without string-matching. */
+    code: 'key_exists' | 'key_not_found' | 'invalid_field');
+}
+/** Current field library (empty when none defined). */
+export declare function getFieldLibrary(config: WorkspaceConfig): CustomFieldDef[];
+/** Look up one definition by key. */
+export declare function getFieldDef(config: WorkspaceConfig, key: string): CustomFieldDef | undefined;
+/**
+ * Validate a field definition's shape. Enforces the key shape and, for select
+ * fields, a non-empty list of unique, non-empty options. Throws
+ * FieldLibraryError on failure. Returns the parsed definition.
+ */
+export declare function validateFieldDef(input: unknown): CustomFieldDef;
+/**
+ * Add a new field definition. Returns a new WorkspaceConfig.
+ * Rejects a key already used by another definition.
+ */
+export declare function addFieldDef(config: WorkspaceConfig, input: {
+    key: string;
+    label?: string;
+    type?: 'select';
+    options: string[];
+    created_by?: string;
+}): WorkspaceConfig;
+/**
+ * Update an existing definition's options and/or label. The key is the
+ * identity and is not changed (renaming a key = add + remove, since it would
+ * orphan existing usages). Returns a new WorkspaceConfig.
+ */
+export declare function updateFieldDef(config: WorkspaceConfig, key: string, patch: {
+    options?: string[];
+    label?: string;
+}): WorkspaceConfig;
+/**
+ * Remove a definition from the library. Returns a new WorkspaceConfig.
+ * Non-destructive to entries — any stored values stay in their frontmatter.
+ */
+export declare function removeFieldDef(config: WorkspaceConfig, key: string): WorkspaceConfig;

package/dist/core/field-library.js

@@ -0,0 +1,129 @@
+/**
+ * Field library mutation helpers
+ *
+ * Pure, framework-free functions that add / edit / remove a reusable custom
+ * field definition on a WorkspaceConfig. They return a new config object (the
+ * input is never mutated) so the HTTP layer can persist the result through
+ * `Workspace.writeConfig()`.
+ *
+ * Deliberately independent of SchemaRegistry / Zod entity validation: the
+ * field library is *soft* metadata (it drives the picker + agent awareness),
+ * not an enforced schema. Applying a field to an entry is an ordinary
+ * frontmatter write elsewhere; nothing here touches entity validation.
+ *
+ * Identity is `key`, global across the workspace (one `phase` everywhere).
+ * Editing options ripples to every entry using the field; existing entry
+ * values are never touched (removal is non-destructive — orphaned values stay
+ * on disk and simply stop being offered).
+ */
+import { CustomFieldDefSchema } from './types.js';
+/** A mutation that fails a precondition (not found, collision, bad shape). */
+export class FieldLibraryError extends Error {
+    code;
+    constructor(message, 
+    /** Stable machine code so the route maps to a status without string-matching. */
+    code) {
+        super(message);
+        this.code = code;
+        this.name = 'FieldLibraryError';
+    }
+}
+/** Field key shape: lowercase, snake_case, must start with a letter. Mirrors
+ *  the client's `normalizedKey` normalization. */
+const KEY_RE = /^[a-z][a-z0-9_]*$/;
+/** Current field library (empty when none defined). */
+export function getFieldLibrary(config) {
+    return config.field_library ?? [];
+}
+/** Look up one definition by key. */
+export function getFieldDef(config, key) {
+    return getFieldLibrary(config).find(f => f.key === key);
+}
+/**
+ * Validate a field definition's shape. Enforces the key shape and, for select
+ * fields, a non-empty list of unique, non-empty options. Throws
+ * FieldLibraryError on failure. Returns the parsed definition.
+ */
+export function validateFieldDef(input) {
+    const parsed = CustomFieldDefSchema.safeParse(input);
+    if (!parsed.success) {
+        throw new FieldLibraryError(`Invalid field definition: ${parsed.error.issues.map(i => i.message).join('; ')}`, 'invalid_field');
+    }
+    const def = parsed.data;
+    if (!KEY_RE.test(def.key)) {
+        throw new FieldLibraryError(`Field key "${def.key}" must be lowercase snake_case and start with a letter`, 'invalid_field');
+    }
+    validateOptions(def.options);
+    return def;
+}
+/** Shared option-list validation (non-empty, no blanks, unique). */
+function validateOptions(options) {
+    if (options.length === 0) {
+        throw new FieldLibraryError('A Select field needs at least one option', 'invalid_field');
+    }
+    if (options.some(v => v.trim() === '')) {
+        throw new FieldLibraryError('Select options cannot be empty', 'invalid_field');
+    }
+    if (new Set(options).size !== options.length) {
+        throw new FieldLibraryError('Select options must be unique', 'invalid_field');
+    }
+}
+/** Deep-clone the library so callers never mutate the live config. */
+function cloneLibrary(config) {
+    return structuredClone(config.field_library ?? []);
+}
+/**
+ * Add a new field definition. Returns a new WorkspaceConfig.
+ * Rejects a key already used by another definition.
+ */
+export function addFieldDef(config, input) {
+    const def = validateFieldDef({
+        key: input.key,
+        type: 'select',
+        options: input.options,
+        ...(input.label !== undefined ? { label: input.label } : {}),
+        ...(input.created_by !== undefined ? { created_by: input.created_by } : {}),
+        created_at: new Date().toISOString(),
+    });
+    if (getFieldDef(config, def.key)) {
+        throw new FieldLibraryError(`A field named "${def.key}" already exists`, 'key_exists');
+    }
+    const library = [...cloneLibrary(config), def];
+    return { ...config, field_library: library };
+}
+/**
+ * Update an existing definition's options and/or label. The key is the
+ * identity and is not changed (renaming a key = add + remove, since it would
+ * orphan existing usages). Returns a new WorkspaceConfig.
+ */
+export function updateFieldDef(config, key, patch) {
+    const current = getFieldDef(config, key);
+    if (!current) {
+        throw new FieldLibraryError(`No field named "${key}"`, 'key_not_found');
+    }
+    if (patch.options !== undefined)
+        validateOptions(patch.options);
+    const next = {
+        ...current,
+        ...(patch.options !== undefined ? { options: patch.options } : {}),
+        ...(patch.label !== undefined ? { label: patch.label } : {}),
+    };
+    const library = cloneLibrary(config).map(f => (f.key === key ? next : f));
+    return { ...config, field_library: library };
+}
+/**
+ * Remove a definition from the library. Returns a new WorkspaceConfig.
+ * Non-destructive to entries — any stored values stay in their frontmatter.
+ */
+export function removeFieldDef(config, key) {
+    if (!getFieldDef(config, key)) {
+        throw new FieldLibraryError(`No field named "${key}"`, 'key_not_found');
+    }
+    const library = cloneLibrary(config).filter(f => f.key !== key);
+    // Drop the array entirely when it empties, to keep workspace.json tidy.
+    const next = { ...config, field_library: library };
+    if (library.length === 0)
+        delete next.field_library;
+    return next;
+}
+//# sourceMappingURL=field-library.js.map

package/dist/core/field-library.js.map

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

package/dist/core/graph.d.ts

@@ -12,6 +12,7 @@ import type { AssetIndexService } from '../services/assets/asset-index-service.j
 import { EntityType, type EntityData, type DatasetRow } from './validation.js';
 import { SchemaRegistry } from './schema-registry.js';
 import { type DatasetFilter } from '../services/csv-service.js';
+import { type HistoryCommitChange } from './history-diff.js';
 import { type VectorService } from '../services/vector-service.js';
 export interface GraphConfig {
     repoPath: string;
@@ -219,9 +220,41 @@ export declare class BaseGraphManager {
     private vectorService?;
     private schemaRegistry?;
     private workspaceRoot?;
+    /** Cache for history-panel change summaries, keyed by `${relPath}@${hash}`.
+     *  A commit's diff against its parent is immutable, so this never needs
+     *  invalidation — entries only accumulate as history is viewed. */
+    private historyChangeCache;
     private persistenceCallbacks?;
     private bodyWriteCoordinator?;
     constructor(config: GraphConfig);
+    /**
+     * Friendly display label for an entity type — custom-type label when the
+     * workspace defines one, otherwise the title-cased key ("deal" → "Deal").
+     * Used to build human-readable commit messages.
+     */
+    private typeLabel;
+    /** Build an EntityRef for a commit message from a type, id, and optional title. */
+    private commitRef;
+    /**
+     * Build the friendly "Edited …" message for a deferred (batched) commit,
+     * given the "type/id" pairs accumulated by the SessionManager. Each title is
+     * resolved from the in-memory index at flush time (cheap lookup); an entity
+     * deleted before the flush falls back to its slug id.
+     */
+    buildEditedBatchMessage(entities: Array<{
+        type: string;
+        id: string;
+    }>): string;
+    /**
+     * Change summary for one commit in a file's history — which frontmatter
+     * fields moved and whether the body changed — by diffing the file at `hash`
+     * against its true git parent (`hash^`). Used by the entity History panel.
+     *
+     * `relPath` is repo-relative. Null parent (root commit, or file absent at the
+     * parent) → `created`. Result is immutable per (path, hash), so it's cached.
+     * Returns null only when the file isn't present at `hash`.
+     */
+    getCommitChange(relPath: string, hash: string): HistoryCommitChange | null;
     /** Expose git service for deferred commit operations (SessionManager). */
     getGitService(): GitService | undefined;
     /** Absolute repo path on disk. Used by callers that need to convert
@@ -407,6 +440,7 @@ export declare class BaseGraphManager {
             entityType: EntityType;
             entityId: string;
             path: string;
+            title?: string;
         }>;
         errors: Array<{
             entityType: EntityType;