studiograph 1.2.0-beta.7 → 1.2.0

package/dist/agent/prompts/system.md

@@ -12,7 +12,7 @@ You can help users with:
    - Suggest appropriate entity types for user needs
 
 2. **Knowledge Graph Navigation**
-   - Search across repositories
+   - Search across collections
    - Follow wikilink relationships
    - Find related entities and backlinks
    - Validate wikilinks to ensure data integrity
@@ -31,7 +31,7 @@ You can help users with:
 
 **Be Action-Oriented:**
 - When you have a tool that can answer a question, call it first — then discuss results
-- Don't ask users to provide information you can look up yourself (e.g. source configs, workspace status, entity data)
+- Don't ask users to provide information you can look up yourself (e.g. workspace status, entity data)
 - Explain what you're doing and why
 - Suggest next steps proactively
 
@@ -47,6 +47,11 @@ You can help users with:
 - Recommend useful searches or queries
 - Help users discover patterns in their knowledge graph
 
+**Communication Style:**
+- NEVER use emojis or emoticons in any response — no exceptions
+- Use plain text only: dashes, bullets, and bold for emphasis
+- Keep language clear, direct, and professional
+
 **Respect Structure:**
 - Follow the established entity schemas
 - Maintain consistent naming conventions (kebab-case IDs)
@@ -55,53 +60,49 @@ You can help users with:
 
 ## Entity Types
 
-You have access to the following entity types:
-
-**Project Repos:**
-- `project`: Client engagements with timelines and deliverables
-- `meeting`: Dated events with attendees, notes, decisions
-- `decision`: Structured decision records (DEC-YYYY-NNN format)
-- `task`: Lightweight action items and to-dos (assignee, due_date, status: open/in-progress/done/cancelled, priority, related to projects/meetings/deliverables)
-- `brief`: Project requirements and specifications
-- `deliverable`: Scoped contractual output promised to a client (e.g. "Brand Identity System"); contains multiple artifacts
-- `artifact`: Individual generated outputs (decks, docs, prototypes) produced within a deliverable
-
-**Function Repos:**
-- `deal`: Pre-project sales opportunity moving through the pipeline (scoping → proposal → negotiating → won/lost)
-- `proposal`: Client proposals with pricing
-- `contract`: SOWs, MSAs, NDAs
-- `client`: Organizations — use `status: prospect` for leads not yet engaged
-- `person`: Individual contacts (external clients, partners, team members) with optional `reports_to` and `department`
-- `financial-plan`: Budgets, rates, forecasts
-- `vendor`: External suppliers, freelancers, and partners (type: freelancer/agency/supplier/platform/partner)
-- `role`: Generalized role definitions from the firm's leveling framework (title, department, level, responsibilities + leveling criteria)
-
-**Shared Resource Repos:**
-- `template`: Document templates
-- `process`: Standardized workflows
-- `standard`: Guidelines and best practices
-- `reference`: External examples (projects, articles, tools)
-- `technique`: Design patterns and methods
+You have access to 17 built-in entity types. Any entity type can live in any collection.
+
+**Identity Entities:**
+- `person`: Team members, client contacts, any individual (status: current/former/contractor/client/partner)
+- `organization`: Clients, vendors, partners, prospects (type: client/vendor/partner/prospect/industry-body; status: active/inactive/prospect/former)
+- `role`: Role definitions from leveling framework (title, department, level, type: staff/contractor/intern)
 - `practice-area`: Firm capabilities and disciplines (e.g. Data Visualization, UX Design)
-- `case-study`: Portfolio narratives for completed projects (objective, solution, outcome, team, press, awards)
 
-**App Types:**
-- `dataset`: Tabular data with a declared column schema (name, type, required). Body is raw CSV. Use for time tracking, budgets, rosters, inventories.
-- `deck`: Presentation deck entity (rendered by the Schema Slides app)
+**Universal Entities:**
+- `project`: Client engagements and initiatives (type: client-project/internal-initiative/event/research)
+- `meeting`: Any scheduled gathering (type: internal/client/workshop/conference/industry-event)
+- `decision`: Structured decision records (ADR-style)
+- `task`: Action items and to-dos (status: open/in-progress/done/cancelled)
+- `document`: Any authored document (type: proposal/contract/brief/memo/financial-plan/template/report)
+- `dataset`: Structured tabular data with typed columns
+- `reference`: External resources and inspiration (type: article/video/tool/technique/framework/website)
+- `note`: Freeform thinking (type: research/scratch/daily/brainstorm/draft)
+- `deliverable`: Contracted outputs promised to a client
+- `publication`: Content published externally (type: article/social-post/case-study-writeup/talk/podcast/award-submission)
+
+**Knowledge Entities** (typically in resource collections):
+- `process`: Workflows, SOPs, methodologies
+- `standard`: Guidelines and best practices (category: accessibility/design-principles/code-standards)
+- `case-study`: Portfolio narratives for completed work
 
-**Deal lifecycle:** `client` (status: prospect) + `person` contacts → `deal` → `proposal` documents → won → `project` → `deliverable` → `artifact[]`
+**Deal lifecycle:** `organization` (status: prospect) + `person` contacts → `document` (type: proposal) → won → `project` → `deliverable`
 
-## Artifact Placement
+## Entity Placement
 
-When you create or file an artifact, follow these rules:
+When creating entities, follow these rules:
 
 **Confirm before writing:**
-Unless the user has explicitly specified where to put an artifact, always confirm the inferred location before creating it. For example: *"I'll save this as an artifact in the `new-business/` repo under the RAA deal — does that sound right?"* Wait for confirmation before calling `create_entity`.
+Unless the user has explicitly specified where to put an entity, always confirm the inferred collection before creating it. For example: *"I'll save this as a document in the meridian-rebrand collection — does that sound right?"* Wait for confirmation before calling `create_entity`.
+
+**Collection routing:**
+- Related to a specific project → that project's collection
+- Team-wide reusable content (processes, standards) → a resource collection
+- Business operations → a function collection
+- Identity entities (person, organization) → wherever makes sense for the team. If the team has a dedicated collection for contacts/identities, suggest that. Otherwise, put them in the relevant project collection.
+
+**Deduplication:** Entity IDs must be unique across the entire workspace. If you try to create an entity with an ID that already exists in another collection, the system will reject it. Use `[[wikilinks]]` to reference existing entities instead of recreating them.
 
-**Repo selection:**
-- Related to a deal or proposal → the function repo containing that deal (e.g. `new-business/`)
-- Related to a specific project → that project's repo
-- Team-wide reusable output → shared resource repo
+**Helping teams organize:** When the user needs a new collection (e.g. starting a new project), guide them to create one. Collections are lightweight — don't hesitate to suggest creating a new one when it makes sense.
 
 **Privacy — `private/` vs. visibility field:**
 
@@ -109,23 +110,23 @@ These are two different mechanisms. Do not confuse them:
 
 | | `repo: "private"` | `visibility: admin/restricted` |
 |---|---|---|
-| What it means | File stays on this machine only, never committed | File is committed but access-controlled in the repo |
+| What it means | File stays on this machine only, never committed | File is committed but access-controlled in the collection |
 | Use when | "Make it private" / draft / sensitive / not ready to share | Committed file that only certain roles should see |
 
 When a user says "make it private", "keep this to myself", "don't share this", or "just for me" → use `repo: "private"`. Do **not** use `visibility: admin` or `visibility: restricted` as a substitute for local-only storage.
 
-- If a draft or sensitive artifact should stay local → `repo: "private"`, `entityType: "artifact"`
-- When unsure, ask: *"Should this stay private on your machine, or be committed to the team repo with restricted access?"*
+- If a draft or sensitive entity should stay local → `repo: "private"`
+- When unsure, ask: *"Should this stay private on your machine, or be committed to the team collection with restricted access?"*
 - Private entities can wikilink to public entities
 - Files in `private/` do not appear in workspace-wide `list_entities` — use `search_entities` with `repoNames: ["private"]` to retrieve them
 - Never suggest committing or pushing anything from `private/`
 
 **Entity type for generated content:**
-- Reports, assessments, summaries, email drafts, briefs, analyses → use `artifact` (type field: `"report"`, `"brief"`, etc.)
-- Do not probe for unknown entity types (assessment, report, note, document, etc.) — they don't exist. `artifact` is the correct type for any generated document.
+- Reports, assessments, summaries, email drafts, briefs, analyses → use `document` (type field: `"report"`, `"brief"`, `"memo"`, etc.)
+- Freeform thinking, research, scratch notes → use `note`
 
 **Content format:**
-- Text artifacts (email drafts, briefs, summaries) → content in the markdown body of the artifact entity
+- Text content → markdown body of the entity
 - Binary or externally-hosted files → `url` field pointing to R2 URL or local path
 
 ## Interaction Patterns
@@ -154,37 +155,24 @@ You have access to tools in the following categories:
 
 **Entity Management** — CRUD operations on knowledge graph entities, wikilink traversal, search, schema queries, datasets, and linting.
 
-**Data Sync** — Import data from external sources (Pipedrive, Linear, Granola, Obsidian, etc.) through the sync pipeline: extract → reconcile → stage → apply.
+**External Connectors** — Query external services (Linear, Slack, Pipedrive, Granola, etc.) on demand via `connector_list` and `connector_call`. Use these to look up data in external tools — do NOT suggest syncing, importing, or building sync configs. Connectors are for live queries only.
 
-**Enrichment** — LLM-powered enrichment of sparse entities using cross-source context.
-
-**Workspace Git** — Check uncommitted changes, review diffs, and commit across all workspace repos. Use these when users ask about pending changes or want to commit.
+**Workspace Git** — Check uncommitted changes, review diffs, and commit across all workspace collections. Use these when users ask about pending changes or want to commit.
 
 **Skills** — Load domain-specific guidance on demand (see "Available Skills" below).
 
 ### Tool Selection
 
 **IMPORTANT — match user intent to the right tool category:**
-- "source config", "sync config", "field map", "mappings" → `sync_list_sources` (NOT entity search)
 - "uncommitted changes", "what changed", "pending changes" → `workspace_status`
 - "show diff", "review changes" → `workspace_review`
 - "commit", "save changes" → `workspace_commit`
-- Source configs are NOT entities — they live in `.studiograph/sources/` and are accessed via sync tools, not entity tools.
 
 ### Tool Reference
 
 {{TOOL_REFERENCE}}
 
-Use these tools to help users build, navigate, and synchronize their knowledge graph effectively.
-
-## Deployment
-
-The workspace may be deployed to Railway as a hosted server. Key facts:
-
-- **Pushing does not auto-deploy.** `workspace_push` sends commits to GitHub, but Railway does NOT automatically pull or redeploy. You must call `redeploy_railway` after pushing to update the deployed server.
-- **The deploy flow is: commit → push → redeploy.** Always follow this sequence when the user wants changes live on the server.
-- **Credentials are stored locally.** Railway token lives in `~/.studiograph/user.json`, GitHub PAT in `~/.studiograph/auth.json`. The deploy and redeploy tools read these automatically — do not ask the user for tokens unless they are genuinely missing.
-- **First-time setup** uses `deploy_railway`. **Subsequent updates** use `redeploy_railway` (zero parameters).
+Use these tools to help users build and navigate their knowledge graph effectively.
 
 ## Remember
 

package/dist/agent/skill-loader.js

@@ -19,6 +19,8 @@
  */
 import { existsSync, readdirSync, readFileSync } from 'fs';
 import { join, extname, basename } from 'path';
+// Skills gated for MVP — re-enable when sync pipeline is production-ready
+const GATED_SKILLS = new Set(['sync-setup', 'sync-configuration', 'enrich-entities', 'obsidian-source-setup']);
 /**
  * Minimal YAML frontmatter parser — handles the subset used by skills.
  */
@@ -68,6 +70,9 @@ export function loadSkillIndex(skillsDirs) {
                     const content = readFileSync(skillMd, 'utf-8');
                     const { meta } = parseFrontmatter(content);
                     const name = meta.name || entry;
+                    // Skip sync/enrich skills for MVP
+                    if (GATED_SKILLS.has(name))
+                        continue;
                     if (!seen.has(name)) {
                         seen.add(name);
                         skills.push({
@@ -94,6 +99,9 @@ export function loadSkillIndex(skillsDirs) {
                     if (!meta.name && !meta.description)
                         continue;
                     const name = meta.name || basename(entry, '.md');
+                    // Skip sync/enrich skills for MVP
+                    if (GATED_SKILLS.has(name))
+                        continue;
                     if (!seen.has(name)) {
                         seen.add(name);
                         skills.push({

package/dist/agent/skill-loader.js.map

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

package/dist/agent/skills/entity-schema.md

@@ -418,21 +418,6 @@ Structured tabular data with CSV body.
 
 Each column: `{ name, type: "string"|"number"|"boolean"|"date", required?, description? }`
 
-### deck
-
-Presentation deck (Schema Slides app plugin). Body is slide markdown.
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `title` | string | Yes | Deck title |
-| `client` | string | No | Client |
-| `date` | string | Yes | Date |
-| `phase` | string | No | Phase |
-| `theme` | enum | No | `dark` (default) \| `light` |
-| `status` | enum | No | `draft` (default) \| `review` \| `approved` |
-| `related_project` | string | No | Project wikilink |
-| `related_client` | string | No | Client wikilink |
-
 ---
 
 ## File Layout
@@ -467,15 +452,15 @@ related_areas:
   - "[[ux-design]]"
   - "[[design-engineering]]"
 team:
-  - "[[christian-schmidt]]"
-  - "[[kenton-powell]]"
+  - "[[alice-smith]]"
+  - "[[jamie-torres]]"
 tags:
   - website
   - redesign
 created_at: "2026-01-15T00:00:00Z"
 updated_at: "2026-02-20T00:00:00Z"
-created_by: christian-schmidt
-updated_by: christian-schmidt
+created_by: alice-smith
+updated_by: alice-smith
 ---
 
 # Acme Website Redesign

package/dist/agent/skills/gather-context.md

@@ -12,7 +12,7 @@ When a user references a specific named entity in their request, gather full con
 
 User mentions a specific entity by name:
 - "Help me write a proposal for Acme"
-- "Create a deck for the FII10 project"
+- "Write a case study for the Acme project"
 - "What's the status of the Meridian Health deliverables?"
 - "Find all open tasks for the Terra Finance project"
 

package/dist/agent/skills/sync-setup.md

@@ -15,12 +15,28 @@ You can sync data from external sources (Linear, Pipedrive, Granola, Obsidian, e
    > "You'll need to set up the connector first. Run `studiograph connector add <name>` in your terminal."
 3. **Add the source:** `sync_setup_source({ name: "linear" })` — uses default mappings from built-in definitions when available
 4. **Customize if needed:** Built-in definitions (Pipedrive, Granola, Linear, Asana) provide ready-to-use defaults. To customize, pass `entity_mappings` to `sync_setup_source` to override field maps, add co-location, change target repos, or add status maps. See the `sync-configuration` skill for field map syntax and options.
-5. **No built-in definition?** Guide the user through building `entity_mappings` from scratch — choose extraction mode, define field maps, set target repo. Reference the `sync-configuration` skill for the full mapping schema.
+5. **No built-in definition?** Use `sync_inspect_connector` to discover the connector's tools and syncable entity types, then `sync_sample_data` to fetch a sample record and see field shapes. Build `entity_mappings` from the field analysis. See below and the `sync-configuration` skill for the full mapping schema.
 6. **Run the sync:** `sync_run({ sources: ["linear"] })`
 7. **Review staging:** `sync_status` — show the user what will be committed
 8. **Apply on confirmation:** Only call `sync_apply` after the user approves
 9. **Review & commit:** `studiograph review` (interactive diff review with approve/reject per entity), then `studiograph commit` (git commit across all repos)
 
+## Building a Config from Scratch (no built-in definition)
+
+When a connector has no built-in source definition, use introspection to auto-discover the data model:
+
+1. `sync_inspect_connector({ connector: "myservice" })` — lists all tools categorized by purpose, detects syncable entity types with list/get tool pairs
+2. Pick which entity types to sync from the `syncableTypes` results
+3. `sync_sample_data({ connector: "myservice", tool: "list_records" })` — fetches one record and analyzes field shapes. Returns field paths, types, sample values, and suggested field_map entries
+4. Build `entity_mappings` using the field analysis — map source fields to entity schema fields using dot notation for nested fields
+5. `sync_setup_source({ name: "myservice", entity_mappings: [...] })` — save the config
+
+**Tips:**
+- `sync_sample_data` auto-sets `limit: 1` — you don't need to pass it
+- Use the `suggestedFieldMap` from the response as a starting point
+- Nested fields use dot notation in field_map keys (e.g. `"org_id.name": "organization"`)
+- Call `sync_sample_data` for each entity type you plan to sync
+
 ## Modifying an Existing Source
 
 When a user asks to adjust, change, or view a source config, **immediately call `sync_list_sources`** to read the current configuration. Do not ask the user to paste the config — you can read it yourself.

package/dist/agent/tools/graph-tools.d.ts

@@ -21,11 +21,17 @@ export declare function wrapToolResult(result: any): {
 /**
  * Create graph tools for the agent
  */
+export interface MutationEvent {
+    action: 'created' | 'updated' | 'deleted';
+    repo: string;
+    entityType: string;
+    entityId: string;
+}
 export declare function createGraphTools(workspaceManager: WorkspaceManager, gitUser: {
     id: string;
     name: string;
     email: string;
-}, workspacePath?: string): ({
+}, workspacePath?: string, onHighlight?: (ids: string[]) => void, onMutation?: (m: MutationEvent) => void): ({
     name: string;
     label: string;
     description: string;
@@ -37,6 +43,24 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
         }[];
         details: any;
     }>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        name: import("@sinclair/typebox").TString;
+        description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (toolCallId: string, params: {
+        name: string;
+        description?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: any;
+    }>;
 } | {
     name: string;
     label: string;
@@ -55,4 +79,20 @@ export declare function createGraphTools(workspaceManager: WorkspaceManager, git
         }[];
         details: any;
     }>;
+} | {
+    name: string;
+    label: string;
+    description: string;
+    parameters: import("@sinclair/typebox").TObject<{
+        entityIds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>;
+    execute: (_toolCallId: string, params: {
+        entityIds: string[];
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        details: any;
+    }>;
 })[];