studiograph 1.0.0

package/dist/utils/git.js

@@ -0,0 +1,55 @@
+/**
+ * Thin wrappers around git shell operations.
+ * Extracted so tests can mock them without mocking the built-in child_process.
+ */
+import { execSync, spawnSync } from 'child_process';
+/**
+ * Pull the latest changes in a local git repo.
+ * Returns 'updated', 'up-to-date', or 'conflict'.
+ * Throws on hard errors (no remote, auth failure, etc.).
+ */
+export function gitPull(repoPath) {
+    const result = spawnSync('git', ['pull'], { cwd: repoPath, encoding: 'utf-8' });
+    if (result.status === 0) {
+        const output = result.stdout + result.stderr;
+        return output.toLowerCase().includes('already up to date') ? 'up-to-date' : 'updated';
+    }
+    const combined = result.stdout + result.stderr;
+    if (combined.includes('CONFLICT') || combined.includes('Automatic merge failed')) {
+        return 'conflict';
+    }
+    throw new Error((result.stderr || result.stdout || `git pull failed with exit ${result.status}`).trim());
+}
+/**
+ * Push local commits in a git repo to its remote.
+ * Returns 'pushed' or 'nothing-to-push'.
+ * Throws on errors (no remote, auth failure, etc.).
+ */
+export function gitPush(repoPath) {
+    const result = spawnSync('git', ['push'], { cwd: repoPath, encoding: 'utf-8' });
+    if (result.status === 0) {
+        const combined = result.stdout + result.stderr;
+        return combined.includes('Everything up-to-date') ? 'nothing-to-push' : 'pushed';
+    }
+    throw new Error((result.stderr || result.stdout || `git push failed with exit ${result.status}`).trim());
+}
+/**
+ * Clone a remote repository to a local path.
+ * Throws if the git command fails.
+ */
+export function gitClone(remoteUrl, localPath) {
+    execSync(`git clone "${remoteUrl}" "${localPath}"`, { stdio: 'pipe' });
+}
+/**
+ * Read a git config value.
+ * Returns undefined if the key is not set.
+ */
+export function getGitConfig(key) {
+    try {
+        return execSync(`git config ${key}`, { stdio: 'pipe' }).toString().trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAKpD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;QACjF,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,6BAA6B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAChF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/C,OAAO,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,6BAA6B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,SAAiB,EAAE,SAAiB;IAC3D,QAAQ,CAAC,cAAc,SAAS,MAAM,SAAS,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,cAAc,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/utils/preflight.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pre-flight environment checks
+ *
+ * Run at the start of init, start, and join to surface missing dependencies
+ * as clear, actionable messages before any command logic executes.
+ */
+/** Minimum supported Node.js major version */
+export declare const MIN_NODE_MAJOR = 18;
+export interface CheckResult {
+    passed: boolean;
+    message: string;
+    hint?: string;
+}
+export interface AuthCheckResult {
+    present: boolean;
+    message: string;
+    hint?: string;
+}
+/**
+ * Check that git is installed and on PATH.
+ */
+export declare function checkGit(): CheckResult;
+/**
+ * Check that the running Node.js meets the minimum version requirement.
+ */
+export declare function checkNode(): CheckResult;
+/**
+ * Check whether a GitHub auth token is stored.
+ * This is contextual — absence is a warning, not a failure.
+ */
+export declare function checkGithubAuth(): AuthCheckResult;
+export interface PreflightOptions {
+    /** Show the GitHub auth contextual check. Default: true */
+    checkGithubAuth?: boolean;
+}
+/**
+ * Run pre-flight checks and print results using clack log symbols.
+ *
+ * Required checks (git, Node.js) print as success or error.
+ * Contextual checks (GitHub auth) print as success or warning.
+ *
+ * Returns false if any required check fails — caller should exit(1).
+ */
+export declare function runPreflight(options?: PreflightOptions): boolean;

package/dist/utils/preflight.js

@@ -0,0 +1,95 @@
+/**
+ * Pre-flight environment checks
+ *
+ * Run at the start of init, start, and join to surface missing dependencies
+ * as clear, actionable messages before any command logic executes.
+ */
+import { execSync } from 'child_process';
+import { log } from '@clack/prompts';
+import { loadToken } from '../auth/github.js';
+/** Minimum supported Node.js major version */
+export const MIN_NODE_MAJOR = 18;
+/**
+ * Check that git is installed and on PATH.
+ */
+export function checkGit() {
+    try {
+        const output = execSync('git --version', { stdio: 'pipe' }).toString().trim();
+        const match = output.match(/git version (\S+)/);
+        const version = match ? match[1] : output;
+        return { passed: true, message: `git ${version} found` };
+    }
+    catch {
+        return {
+            passed: false,
+            message: 'git not found',
+            hint: 'Install git from https://git-scm.com',
+        };
+    }
+}
+/**
+ * Check that the running Node.js meets the minimum version requirement.
+ */
+export function checkNode() {
+    const version = process.versions.node;
+    const major = parseInt(version.split('.')[0], 10);
+    if (major >= MIN_NODE_MAJOR) {
+        return { passed: true, message: `Node.js v${version} found` };
+    }
+    return {
+        passed: false,
+        message: `Node.js v${version} is too old (requires v${MIN_NODE_MAJOR}+)`,
+        hint: `Install Node.js v${MIN_NODE_MAJOR}+ from https://nodejs.org`,
+    };
+}
+/**
+ * Check whether a GitHub auth token is stored.
+ * This is contextual — absence is a warning, not a failure.
+ */
+export function checkGithubAuth() {
+    const stored = loadToken();
+    if (stored) {
+        return { present: true, message: `GitHub auth configured (${stored.user.login})` };
+    }
+    return {
+        present: false,
+        message: 'GitHub auth not configured',
+        hint: 'run `studiograph auth github` to set up',
+    };
+}
+/**
+ * Run pre-flight checks and print results using clack log symbols.
+ *
+ * Required checks (git, Node.js) print as success or error.
+ * Contextual checks (GitHub auth) print as success or warning.
+ *
+ * Returns false if any required check fails — caller should exit(1).
+ */
+export function runPreflight(options = {}) {
+    const { checkGithubAuth: checkAuth = true } = options;
+    const gitResult = checkGit();
+    const nodeResult = checkNode();
+    if (gitResult.passed) {
+        log.success(gitResult.message);
+    }
+    else {
+        log.error(`${gitResult.message}${gitResult.hint ? ` — ${gitResult.hint}` : ''}`);
+    }
+    if (nodeResult.passed) {
+        log.success(nodeResult.message);
+    }
+    else {
+        log.error(`${nodeResult.message}${nodeResult.hint ? ` — ${nodeResult.hint}` : ''}`);
+    }
+    if (checkAuth) {
+        const authResult = checkGithubAuth();
+        if (authResult.present) {
+            log.success(authResult.message);
+        }
+        else {
+            log.warn(`${authResult.message}${authResult.hint ? ` — ${authResult.hint}` : ''}`);
+        }
+    }
+    return gitResult.passed && nodeResult.passed;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/utils/preflight.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "studiograph",
+  "version": "1.0.0",
+  "description": "Team-based AI agent platform with Git-backed knowledge graphs",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "studiograph": "dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "knowledge-graph",
+    "git",
+    "markdown"
+  ],
+  "author": "Studiograph",
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.20.0",
+    "@aws-sdk/client-s3": "^3.500.0",
+    "@clack/prompts": "^0.7.0",
+    "@fastify/cors": "^9.0.1",
+    "@mariozechner/pi-agent-core": "latest",
+    "@mariozechner/pi-ai": "latest",
+    "@octokit/rest": "^20.0.0",
+    "commander": "^11.1.0",
+    "csv-parse": "^5.6.0",
+    "csv-stringify": "^6.6.0",
+    "fastify": "^4.29.1",
+    "glob": "^10.3.10",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.1",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  }
+}