studiograph 1.0.0

package/dist/core/types.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Core types for Studiograph workspace and repo management
+ */
+import { z } from 'zod';
+/**
+ * Base entity metadata (all entities have these fields)
+ */
+export declare const EntityBaseSchema: z.ZodObject<{
+    entity_type: z.ZodString;
+    entity_id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    updated_by: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    entity_type: z.ZodString;
+    entity_id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    updated_by: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    entity_type: z.ZodString;
+    entity_id: z.ZodString;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+    created_by: z.ZodString;
+    updated_by: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, z.ZodTypeAny, "passthrough">>;
+export type EntityBase = z.infer<typeof EntityBaseSchema>;
+/**
+ * Repo types in Studiograph
+ */
+export declare enum RepoType {
+    PROJECT = "project",// One per client/project
+    FUNCTION = "function",// Business operations
+    SHARED_RESOURCE = "shared-resource"
+}
+/**
+ * Repo configuration in registry
+ */
+export declare const RepoConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodNativeEnum<typeof RepoType>;
+    path: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    access: z.ZodDefault<z.ZodEnum<["public", "team", "admin", "restricted"]>>;
+    github_url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    path: string;
+    type: RepoType;
+    access: "public" | "team" | "admin" | "restricted";
+    description?: string | undefined;
+    github_url?: string | undefined;
+}, {
+    name: string;
+    path: string;
+    type: RepoType;
+    description?: string | undefined;
+    access?: "public" | "team" | "admin" | "restricted" | undefined;
+    github_url?: string | undefined;
+}>;
+export type RepoConfig = z.infer<typeof RepoConfigSchema>;
+export type RepoConfigInput = Omit<RepoConfig, 'path' | 'access'> & {
+    access?: RepoConfig['access'];
+};
+/**
+ * Workspace configuration
+ */
+export declare const WorkspaceConfigSchema: z.ZodObject<{
+    version: z.ZodString;
+    team_name: z.ZodString;
+    created_at: z.ZodString;
+    repos: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodNativeEnum<typeof RepoType>;
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        access: z.ZodDefault<z.ZodEnum<["public", "team", "admin", "restricted"]>>;
+        github_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        path: string;
+        type: RepoType;
+        access: "public" | "team" | "admin" | "restricted";
+        description?: string | undefined;
+        github_url?: string | undefined;
+    }, {
+        name: string;
+        path: string;
+        type: RepoType;
+        description?: string | undefined;
+        access?: "public" | "team" | "admin" | "restricted" | undefined;
+        github_url?: string | undefined;
+    }>, "many">;
+    model_provider: z.ZodOptional<z.ZodString>;
+    model_id: z.ZodOptional<z.ZodString>;
+    api_key: z.ZodOptional<z.ZodString>;
+    anthropic_api_key: z.ZodOptional<z.ZodString>;
+    r2_config: z.ZodOptional<z.ZodObject<{
+        account_id: z.ZodOptional<z.ZodString>;
+        bucket: z.ZodOptional<z.ZodString>;
+        public_url: z.ZodOptional<z.ZodString>;
+        access_key_id: z.ZodOptional<z.ZodString>;
+        secret_access_key: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        account_id?: string | undefined;
+        bucket?: string | undefined;
+        public_url?: string | undefined;
+        access_key_id?: string | undefined;
+        secret_access_key?: string | undefined;
+    }, {
+        account_id?: string | undefined;
+        bucket?: string | undefined;
+        public_url?: string | undefined;
+        access_key_id?: string | undefined;
+        secret_access_key?: string | undefined;
+    }>>;
+    github: z.ZodOptional<z.ZodObject<{
+        org: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        org?: string | undefined;
+    }, {
+        org?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    created_at: string;
+    version: string;
+    team_name: string;
+    repos: {
+        name: string;
+        path: string;
+        type: RepoType;
+        access: "public" | "team" | "admin" | "restricted";
+        description?: string | undefined;
+        github_url?: string | undefined;
+    }[];
+    model_provider?: string | undefined;
+    model_id?: string | undefined;
+    api_key?: string | undefined;
+    anthropic_api_key?: string | undefined;
+    r2_config?: {
+        account_id?: string | undefined;
+        bucket?: string | undefined;
+        public_url?: string | undefined;
+        access_key_id?: string | undefined;
+        secret_access_key?: string | undefined;
+    } | undefined;
+    github?: {
+        org?: string | undefined;
+    } | undefined;
+}, {
+    created_at: string;
+    version: string;
+    team_name: string;
+    repos: {
+        name: string;
+        path: string;
+        type: RepoType;
+        description?: string | undefined;
+        access?: "public" | "team" | "admin" | "restricted" | undefined;
+        github_url?: string | undefined;
+    }[];
+    model_provider?: string | undefined;
+    model_id?: string | undefined;
+    api_key?: string | undefined;
+    anthropic_api_key?: string | undefined;
+    r2_config?: {
+        account_id?: string | undefined;
+        bucket?: string | undefined;
+        public_url?: string | undefined;
+        access_key_id?: string | undefined;
+        secret_access_key?: string | undefined;
+    } | undefined;
+    github?: {
+        org?: string | undefined;
+    } | undefined;
+}>;
+export type WorkspaceConfig = z.infer<typeof WorkspaceConfigSchema>;
+/**
+ * Entity with full data (frontmatter + content)
+ */
+export interface Entity extends EntityBase {
+    content?: string;
+    wikilinks?: string[];
+    [key: string]: any;
+}
+/**
+ * User context for operations
+ */
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+    role?: 'admin' | 'member' | 'guest';
+}
+/**
+ * Git change tracking
+ */
+export interface GitChange {
+    operation: 'create' | 'update' | 'delete';
+    repo: string;
+    filePath: string;
+    entityType: string;
+    entityId: string;
+}
+/**
+ * Permission error thrown when user lacks access to a repository
+ */
+export declare class PermissionError extends Error {
+    constructor(message: string);
+}

package/dist/core/types.js

@@ -0,0 +1,71 @@
+/**
+ * Core types for Studiograph workspace and repo management
+ */
+import { z } from 'zod';
+/**
+ * Base entity metadata (all entities have these fields)
+ */
+export const EntityBaseSchema = z.object({
+    entity_type: z.string(),
+    entity_id: z.string().regex(/^[a-z0-9-]+$/, 'Entity ID must be kebab-case'),
+    created_at: z.string().datetime(),
+    updated_at: z.string().datetime(),
+    created_by: z.string(),
+    updated_by: z.string(),
+    tags: z.array(z.string()).optional(),
+}).passthrough(); // Allow custom fields
+/**
+ * Repo types in Studiograph
+ */
+export var RepoType;
+(function (RepoType) {
+    RepoType["PROJECT"] = "project";
+    RepoType["FUNCTION"] = "function";
+    RepoType["SHARED_RESOURCE"] = "shared-resource";
+})(RepoType || (RepoType = {}));
+/**
+ * Repo configuration in registry
+ */
+export const RepoConfigSchema = z.object({
+    name: z.string(),
+    type: z.nativeEnum(RepoType),
+    path: z.string(), // Relative to workspace root
+    description: z.string().optional(),
+    access: z.enum(['public', 'team', 'admin', 'restricted']).default('team'),
+    github_url: z.string().optional(),
+});
+/**
+ * Workspace configuration
+ */
+export const WorkspaceConfigSchema = z.object({
+    version: z.string(),
+    team_name: z.string(),
+    created_at: z.string().datetime(),
+    repos: z.array(RepoConfigSchema),
+    // Model configuration
+    model_provider: z.string().optional(), // e.g., 'anthropic', 'openai', 'google'
+    model_id: z.string().optional(), // e.g., 'claude-sonnet-4-5-20250929'
+    api_key: z.string().optional(), // Unified API key field
+    // Legacy field (deprecated, use api_key instead)
+    anthropic_api_key: z.string().optional(),
+    r2_config: z.object({
+        account_id: z.string().optional(),
+        bucket: z.string().optional(),
+        public_url: z.string().optional(),
+        access_key_id: z.string().optional(),
+        secret_access_key: z.string().optional(),
+    }).optional(),
+    github: z.object({
+        org: z.string().optional(),
+    }).optional(),
+});
+/**
+ * Permission error thrown when user lacks access to a repository
+ */
+export class PermissionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PermissionError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/core/user-config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * User-level configuration for Studiograph
+ *
+ * Stored at ~/.studiograph/user.json — never committed to git.
+ * Holds personal credentials and preferences that should not be shared
+ * with the team (API keys, preferred model, etc.).
+ *
+ * This mirrors the pattern established by ~/.studiograph/auth.json
+ * for GitHub tokens.
+ */
+export interface UserConfig {
+    model_provider?: string;
+    model_id?: string;
+    api_key?: string;
+}
+export declare const USER_CONFIG_PATH: string;
+/**
+ * Load the user config from ~/.studiograph/user.json.
+ * Returns an empty object if the file does not exist or cannot be parsed.
+ */
+export declare function loadUserConfig(): UserConfig;
+/**
+ * Persist the user config to ~/.studiograph/user.json with mode 0600
+ * (owner read/write only — keeps API keys off shared file systems).
+ */
+export declare function saveUserConfig(config: UserConfig): void;
+/**
+ * Save model provider, model ID, and optional API key to user config.
+ * Merges with any existing user config so other fields are preserved.
+ */
+export declare function setUserModelConfig(provider: string, modelId: string, apiKey?: string): void;

package/dist/core/user-config.js

@@ -0,0 +1,50 @@
+/**
+ * User-level configuration for Studiograph
+ *
+ * Stored at ~/.studiograph/user.json — never committed to git.
+ * Holds personal credentials and preferences that should not be shared
+ * with the team (API keys, preferred model, etc.).
+ *
+ * This mirrors the pattern established by ~/.studiograph/auth.json
+ * for GitHub tokens.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const USER_CONFIG_DIR = join(homedir(), '.studiograph');
+export const USER_CONFIG_PATH = join(USER_CONFIG_DIR, 'user.json');
+/**
+ * Load the user config from ~/.studiograph/user.json.
+ * Returns an empty object if the file does not exist or cannot be parsed.
+ */
+export function loadUserConfig() {
+    if (!existsSync(USER_CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(USER_CONFIG_PATH, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Persist the user config to ~/.studiograph/user.json with mode 0600
+ * (owner read/write only — keeps API keys off shared file systems).
+ */
+export function saveUserConfig(config) {
+    mkdirSync(USER_CONFIG_DIR, { recursive: true });
+    writeFileSync(USER_CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+}
+/**
+ * Save model provider, model ID, and optional API key to user config.
+ * Merges with any existing user config so other fields are preserved.
+ */
+export function setUserModelConfig(provider, modelId, apiKey) {
+    const current = loadUserConfig();
+    current.model_provider = provider;
+    current.model_id = modelId;
+    if (apiKey)
+        current.api_key = apiKey;
+    saveUserConfig(current);
+}
+//# sourceMappingURL=user-config.js.map

package/dist/core/user-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/core/user-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAQ7B,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAe,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,SAAS,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAe;IACnF,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,OAAO,CAAC,cAAc,GAAG,QAAQ,CAAC;IAClC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC3B,IAAI,MAAM;QAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;IACrC,cAAc,CAAC,OAAO,CAAC,CAAC;AAC1B,CAAC"}