@nntoan/gstack 0.0.1

package/dist/mcp/backlog-md.d.ts

@@ -0,0 +1,2 @@
+import type { StdioMcpConfig } from './types.ts';
+export declare function createBacklogMdConfig(): StdioMcpConfig;

package/dist/mcp/context7.d.ts

@@ -0,0 +1,2 @@
+import type { RemoteMcpConfig } from './types.ts';
+export declare const context7: RemoteMcpConfig;

package/dist/mcp/contexthub.d.ts

@@ -0,0 +1,2 @@
+import type { StdioMcpConfig } from './types.ts';
+export declare function createContexthubConfig(): StdioMcpConfig;

package/dist/mcp/grep-app.d.ts

@@ -0,0 +1,2 @@
+import type { RemoteMcpConfig } from './types.ts';
+export declare const grep_app: RemoteMcpConfig;

package/dist/mcp/index.d.ts

@@ -0,0 +1,5 @@
+import type { GstackConfig } from '../types/config.ts';
+import type { RemoteMcpConfig, StdioMcpConfig } from './types.ts';
+export { McpNameSchema, type McpName } from './types.ts';
+type McpServerConfig = RemoteMcpConfig | StdioMcpConfig;
+export declare function createBuiltinMcps(disabledMcps?: string[], _config?: GstackConfig): Record<string, McpServerConfig>;

package/dist/mcp/types.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const McpNameSchema: z.ZodEnum<{
+    websearch: "websearch";
+    context7: "context7";
+    contexthub: "contexthub";
+    grep_app: "grep_app";
+    backlog_md: "backlog_md";
+}>;
+export type McpName = z.infer<typeof McpNameSchema>;
+export declare const AnyMcpNameSchema: z.ZodString;
+export type AnyMcpName = z.infer<typeof AnyMcpNameSchema>;
+export type RemoteMcpConfig = {
+    type: 'remote';
+    url: string;
+    enabled: boolean;
+    headers?: Record<string, string>;
+    oauth?: false;
+};
+export type StdioMcpConfig = {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    enabled: boolean;
+    env?: Record<string, string>;
+};

package/dist/mcp/websearch.d.ts

@@ -0,0 +1,3 @@
+import type { WebsearchMcpConfig } from '../config/schema/mcp-schema.ts';
+import type { RemoteMcpConfig } from './types.ts';
+export declare function createWebsearchConfig(config?: WebsearchMcpConfig): RemoteMcpConfig;

package/dist/plugin-config.d.ts

@@ -0,0 +1,4 @@
+import type { GstackConfig } from './types/config.ts';
+export declare function parseConfigPartially(rawConfig: Record<string, unknown>): Partial<GstackConfig> | null;
+export declare function loadConfigFromPath(configPath: string, _ctx: unknown): Partial<GstackConfig> | null;
+export declare function loadPluginConfig(directory: string, _ctx: unknown): GstackConfig;

package/dist/plugin-handlers/config-handler.d.ts

@@ -0,0 +1,10 @@
+import type { GstackConfig } from '../types/config.ts';
+import type { GstackSkill } from '../types/skill.ts';
+export interface ConfigHandlerDeps {
+    ctx: {
+        directory: string;
+    };
+    pluginConfig: GstackConfig;
+    skills?: GstackSkill[];
+}
+export declare function createConfigHandler(deps: ConfigHandlerDeps): (config: Record<string, unknown>) => Promise<void>;

package/dist/plugin-handlers/index.d.ts

@@ -0,0 +1,3 @@
+export { createConfigHandler } from './config-handler.ts';
+export { applyMcpConfig } from './mcp-config-handler.ts';
+export type { ConfigHandlerDeps } from './config-handler.ts';

package/dist/plugin-handlers/mcp-config-handler.d.ts

@@ -0,0 +1,7 @@
+import type { GstackConfig } from '../types/config.ts';
+import type { GstackSkill } from '../types/skill.ts';
+export declare function applyMcpConfig(params: {
+    config: Record<string, unknown>;
+    pluginConfig: GstackConfig;
+    skills?: GstackSkill[];
+}): Promise<void>;

package/dist/plugin-interface.d.ts

@@ -0,0 +1,18 @@
+import type { GstackConfig } from './types/config.ts';
+import type { GstackSkill } from './types/skill.ts';
+import type { GstackAgent } from './types/agent.ts';
+import type { Managers } from './create-managers.ts';
+import type { Orchestrator } from './features/orchestrator/index.ts';
+export type PluginInterfaceParams = {
+    ctx: {
+        directory: string;
+    };
+    pluginConfig: GstackConfig;
+    managers: Managers;
+    hooks: Record<string, unknown>;
+    tools: Record<string, unknown>;
+    orchestrator: Orchestrator;
+    skills: GstackSkill[];
+    agents: GstackAgent[];
+};
+export declare function createPluginInterface(params: PluginInterfaceParams): Record<string, unknown>;

package/dist/shared/deep-merge.d.ts

@@ -0,0 +1,2 @@
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+export declare function deepMerge<T extends Record<string, unknown>>(base: T | undefined, override: T | undefined, depth?: number): T | undefined;

package/dist/shared/index.d.ts

@@ -0,0 +1,3 @@
+export { log, getLogFilePath } from './logger.ts';
+export { deepMerge, isPlainObject } from './deep-merge.ts';
+export { getGstackDir, getBrowserDir, getOrchestratorDir, getPlansDir, getNotepadsDir, getEvidenceDir, getReviewsDir, getSessionsDir, getAnalyticsDir, getRulesDir, getDesignDocsDir, getBrowseStatePath, getBoulderPath, getStatePath, getSprintLogPath, getBacklogDir, ensureDir, } from './path-helpers.ts';

package/dist/shared/logger.d.ts

@@ -0,0 +1,2 @@
+export declare function log(message: string, data?: unknown): void;
+export declare function getLogFilePath(): string;

package/dist/shared/path-helpers.d.ts

@@ -0,0 +1,17 @@
+export declare function getGstackDir(projectDir: string): string;
+export declare function getBrowserDir(projectDir: string): string;
+export declare function getOrchestratorDir(projectDir: string): string;
+export declare function getPlansDir(projectDir: string): string;
+export declare function getNotepadsDir(projectDir: string, planName: string): string;
+export declare function getEvidenceDir(projectDir: string): string;
+export declare function getReviewsDir(projectDir: string): string;
+export declare function getSessionsDir(projectDir: string): string;
+export declare function getAnalyticsDir(projectDir: string): string;
+export declare function getRulesDir(projectDir: string): string;
+export declare function getDesignDocsDir(projectDir: string): string;
+export declare function getBrowseStatePath(projectDir: string): string;
+export declare function getBoulderPath(projectDir: string): string;
+export declare function getStatePath(projectDir: string): string;
+export declare function getSprintLogPath(projectDir: string): string;
+export declare function getBacklogDir(projectDir: string): string;
+export declare function ensureDir(dirPath: string): Promise<void>;

package/dist/types/agent.d.ts

@@ -0,0 +1,12 @@
+export type SprintPhase = 'think' | 'plan' | 'build' | 'review' | 'test' | 'ship' | 'reflect' | 'cross-cutting' | 'utility';
+export type AgentRole = 'ceo' | 'eng-manager' | 'designer' | 'builder' | 'reviewer' | 'debugger' | 'qa-lead' | 'release-engineer' | 'doc-engineer' | 'retro-lead' | 'safety-guard' | 'upgrader' | 'session-manager';
+export interface GstackAgent {
+    role: AgentRole;
+    name: string;
+    description: string;
+    sprintPhase: SprintPhase;
+    skills: string[];
+    instructions: string;
+    model?: string;
+    subtask?: boolean;
+}

package/dist/types/config.d.ts

@@ -0,0 +1,39 @@
+export type OrchestrationMode = 'multi-agent' | 'skills-only';
+export interface BacklogConfig {
+    enabled: boolean;
+    auto_create_tasks: boolean;
+    auto_update_status: boolean;
+}
+export interface AgentOverrideConfig {
+    model?: string;
+    instructions?: string;
+    enabled?: boolean;
+}
+export interface McpOverrideConfig {
+    enabled?: boolean;
+    url?: string;
+    api_key?: string;
+}
+export interface BrowserConfig {
+    headless: boolean;
+    timeout_ms: number;
+}
+export interface TelemetryConfig {
+    enabled: boolean;
+    supabase?: {
+        url?: string;
+        key?: string;
+    };
+}
+export interface GstackConfig {
+    orchestration_mode: OrchestrationMode;
+    disabled_skills: string[];
+    disabled_agents: string[];
+    disabled_mcps: string[];
+    disabled_hooks: string[];
+    agents?: Record<string, AgentOverrideConfig>;
+    mcp?: Record<string, McpOverrideConfig>;
+    backlog: BacklogConfig;
+    browser?: BrowserConfig;
+    telemetry?: TelemetryConfig;
+}

package/dist/types/mcp.d.ts

@@ -0,0 +1,11 @@
+export interface McpServerConfig {
+    type: 'remote' | 'stdio';
+    url?: string;
+    command?: string;
+    args?: string[];
+    enabled: boolean;
+    headers?: Record<string, string>;
+    oauth?: false;
+}
+export type McpName = 'websearch' | 'context7' | 'contexthub' | 'grep_app' | 'backlog_md';
+export type McpTier = 'builtin' | 'user' | 'skill-embedded';

package/dist/types/orchestrator.d.ts

@@ -0,0 +1,30 @@
+import type { SprintPhase, AgentRole } from './agent.ts';
+export interface UserIntent {
+    raw: string;
+    phase: SprintPhase;
+    confidence: number;
+}
+export interface DelegationResult {
+    agent: AgentRole;
+    skills: string[];
+    reasoning: string;
+}
+export interface BoulderState {
+    activePlan?: string;
+    startedAt?: string;
+    sessionIds: string[];
+    planName?: string;
+    currentPhase?: SprintPhase;
+}
+export interface SprintLogEntry {
+    timestamp: string;
+    phase: SprintPhase;
+    agent: AgentRole;
+    action: string;
+}
+export interface SessionState {
+    sessionId: string;
+    pid: number;
+    startTime: string;
+    agentType: string;
+}

package/dist/types/skill.d.ts

@@ -0,0 +1,20 @@
+export interface BuiltinSkill {
+    name: string;
+    description: string;
+    template: string;
+    allowedTools?: string[];
+    mcpConfig?: Record<string, unknown>;
+    agent?: string;
+    model?: string;
+    subtask?: boolean;
+    argumentHint?: string;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, unknown>;
+}
+export type SkillGroup = 'planning' | 'review' | 'safety' | 'utility' | 'deploy' | 'browser';
+export interface GstackSkill extends BuiltinSkill {
+    group: SkillGroup;
+    originalSkillName: string;
+    browserRequired: boolean;
+}

package/dist/types.d.ts

@@ -0,0 +1,5 @@
+export type { BuiltinSkill, SkillGroup, GstackSkill } from './types/skill.ts';
+export type { SprintPhase, AgentRole, GstackAgent } from './types/agent.ts';
+export type { OrchestrationMode, GstackConfig, BacklogConfig, AgentOverrideConfig, McpOverrideConfig, BrowserConfig, TelemetryConfig, } from './types/config.ts';
+export type { McpServerConfig, McpName, McpTier } from './types/mcp.ts';
+export type { UserIntent, DelegationResult, BoulderState, SprintLogEntry, SessionState, } from './types/orchestrator.ts';

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@nntoan/gstack",
+  "version": "0.0.1",
+  "description": "Use Garry Tan's exact OpenCode setup: 15 opinionated tools that serve as CEO, Designer, Eng Manager, Release Manager, Doc Engineer, and QA",
+  "author": {
+    "name": "Toan Nguyen",
+    "email": "hello@nntoan.com"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "gstack": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schema.json": "./schemas/config.schema.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nntoan/gstack-opencode.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "src/version.ts",
+    "schemas"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build:cli": "bun build src/cli/index.ts --outfile dist/cli.js --target bun --format esm",
+    "build:all": "bun run build && bun run build:cli",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build:all",
+    "build:platform": "bun run scripts/build-platform.ts",
+    "generate:schema": "bun scripts/generate-schema.ts",
+    "sync:upstream": "bun scripts/upstream-sync.ts",
+    "test": "bun test",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "@opencode-ai/plugin": "^1.2.24",
+    "@opencode-ai/sdk": "^1.2.24",
+    "commander": "^14.0.2",
+    "diff": "^8.0.3",
+    "jsonc-parser": "^3.3.1",
+    "picocolors": "^1.1.1",
+    "zod": "^4.1.8"
+  },
+  "peerDependencies": {
+    "playwright": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@nntoan/gstack-darwin-arm64": "0.0.1",
+    "@nntoan/gstack-darwin-x64": "0.0.1",
+    "@nntoan/gstack-linux-arm64": "0.0.1",
+    "@nntoan/gstack-linux-x64": "0.0.1",
+    "@nntoan/gstack-linux-arm64-musl": "0.0.1",
+    "@nntoan/gstack-linux-x64-musl": "0.0.1",
+    "@nntoan/gstack-win32-arm64": "0.0.1",
+    "@nntoan/gstack-win32-x64": "0.0.1",
+    "@nntoan/gstack-win32-ia32": "0.0.1",
+    "@nntoan/gstack-freebsd-x64": "0.0.1",
+    "@nntoan/gstack-freebsd-arm64": "0.0.1",
+    "@nntoan/gstack-openbsd-x64": "0.0.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@typescript-eslint/eslint-plugin": "8.47.0",
+    "@typescript-eslint/parser": "8.47.0",
+    "bun-types": "1.3.10",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-plugin-prettier": "^5.1.3",
+    "playwright": "^1.46.1",
+    "prettier": "^3.2.4",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^3.2.4"
+  }
+}

package/schemas/config.schema.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/nntoan/opencode-gstack/main/schemas/config.schema.json",
+  "type": "object",
+  "properties": {
+    "orchestration_mode": {
+      "type": "string",
+      "enum": [
+        "multi-agent",
+        "skills-only"
+      ],
+      "default": "multi-agent",
+      "description": "Orchestration mode for agent execution"
+    },
+    "disabled_skills": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [],
+      "description": "List of disabled skill names"
+    },
+    "disabled_agents": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [],
+      "description": "List of disabled agent names"
+    },
+    "disabled_mcps": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [],
+      "description": "List of disabled MCP names"
+    },
+    "disabled_hooks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": [],
+      "description": "List of disabled hook names"
+    },
+    "agents": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "model": {
+            "type": "string",
+            "description": "Override model name for this agent"
+          },
+          "instructions": {
+            "type": "string",
+            "description": "Custom instructions for this agent"
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Enable or disable this agent"
+          }
+        }
+      },
+      "description": "Per-agent configuration overrides"
+    },
+    "mcp": {
+      "type": "object",
+      "properties": {
+        "websearch": {
+          "type": "object",
+          "properties": {
+            "provider": {
+              "type": "string",
+              "enum": [
+                "exa",
+                "tavily"
+              ],
+              "default": "exa"
+            },
+            "api_key": {
+              "type": "string"
+            },
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        },
+        "context7": {
+          "type": "object",
+          "properties": {
+            "api_key": {
+              "type": "string"
+            },
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        },
+        "contexthub": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        },
+        "grep_app": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        },
+        "backlog_md": {
+          "type": "object",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true
+            }
+          }
+        }
+      },
+      "description": "MCP configuration"
+    },
+    "backlog": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "auto_create_tasks": {
+          "type": "boolean",
+          "default": true
+        },
+        "auto_update_status": {
+          "type": "boolean",
+          "default": true
+        }
+      },
+      "default": {},
+      "description": "Backlog system configuration"
+    },
+    "browser": {
+      "type": "object",
+      "properties": {
+        "headless": {
+          "type": "boolean",
+          "default": true
+        },
+        "timeout_ms": {
+          "type": "number",
+          "default": 30000
+        }
+      },
+      "description": "Browser automation configuration"
+    },
+    "telemetry": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "supabase": {
+          "type": "object",
+          "properties": {
+            "url": {
+              "type": "string"
+            },
+            "key": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "description": "Telemetry configuration"
+    }
+  },
+  "additionalProperties": false
+}