opencode-synced 0.3.0 → 0.4.0

package/dist/command/sync-enable-secrets.md

@@ -0,0 +1,6 @@
+---
+description: Enable secrets sync (private repo required)
+---
+
+Use the opencode_sync tool with command "enable-secrets".
+If the user supplies extra secret paths, pass them via extraSecretPaths.

package/dist/command/sync-init.md

@@ -0,0 +1,11 @@
+---
+description: Initialize opencode-synced configuration
+---
+
+Use the opencode_sync tool with command "init".
+The repo will be created automatically if it doesn't exist (private by default).
+Default repo name is "my-opencode-config" with owner auto-detected from GitHub CLI.
+If the user wants a custom repo name, pass name="custom-name".
+If the user wants an org-owned repo, pass owner="org-name".
+If the user wants a public repo, pass private=false.
+Include includeSecrets if the user explicitly opts in.

package/dist/command/sync-link.md

@@ -0,0 +1,15 @@
+---
+description: Link this computer to an existing sync repo
+---
+
+Use the opencode_sync tool with command "link".
+This command is for linking a second (or additional) computer to an existing sync repo that was created on another machine.
+
+IMPORTANT: This will OVERWRITE the local OpenCode configuration with the contents from the synced repo. The only thing preserved is the local overrides file (opencode-synced.overrides.jsonc).
+
+If the user provides a repo name argument, pass it as name="repo-name".
+If no repo name is provided, the tool will automatically search for common sync repo names.
+
+After linking:
+- Remind the user to restart OpenCode to apply the synced config
+- If they want to enable secrets sync, they should run /sync-enable-secrets

package/dist/command/sync-pull.md

@@ -0,0 +1,6 @@
+---
+description: Pull and apply synced OpenCode config
+---
+
+Use the opencode_sync tool with command "pull".
+If updates are applied, remind the user to restart OpenCode.

package/dist/command/sync-push.md

@@ -0,0 +1,5 @@
+---
+description: Push local OpenCode config to the sync repo
+---
+
+Use the opencode_sync tool with command "push".

package/dist/command/sync-resolve.md

@@ -0,0 +1,5 @@
+---
+description: Resolve uncommitted changes in sync repo
+---
+
+Use the opencode_sync tool with command "resolve" to automatically resolve uncommitted changes in the local sync repository using AI.

package/dist/command/sync-status.md

@@ -0,0 +1,5 @@
+---
+description: Show opencode-synced status
+---
+
+Use the opencode_sync tool with command "status" and report the results.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from '@opencode-ai/plugin';
+export declare const OpencodeConfigSync: Plugin;

package/dist/sync/apply.d.ts

@@ -0,0 +1,3 @@
+import type { SyncPlan } from './paths.ts';
+export declare function syncRepoToLocal(plan: SyncPlan, overrides: Record<string, unknown> | null): Promise<void>;
+export declare function syncLocalToRepo(plan: SyncPlan, overrides: Record<string, unknown> | null): Promise<void>;

package/dist/sync/commit.d.ts

@@ -0,0 +1,9 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+type CommitClient = PluginInput['client'];
+type Shell = PluginInput['$'];
+interface CommitContext {
+    client: CommitClient;
+    $: Shell;
+}
+export declare function generateCommitMessage(ctx: CommitContext, repoDir: string, fallbackDate?: Date): Promise<string>;
+export {};

package/dist/sync/config.d.ts

@@ -0,0 +1,35 @@
+import type { SyncLocations } from './paths.ts';
+export interface SyncRepoConfig {
+    url?: string;
+    owner?: string;
+    name?: string;
+    branch?: string;
+}
+export interface SyncConfig {
+    repo?: SyncRepoConfig;
+    localRepoPath?: string;
+    includeSecrets?: boolean;
+    includeSessions?: boolean;
+    includePromptStash?: boolean;
+    extraSecretPaths?: string[];
+}
+export interface SyncState {
+    lastPull?: string;
+    lastPush?: string;
+    lastRemoteUpdate?: string;
+}
+export declare function pathExists(filePath: string): Promise<boolean>;
+export declare function normalizeSyncConfig(config: SyncConfig): SyncConfig;
+export declare function loadSyncConfig(locations: SyncLocations): Promise<SyncConfig | null>;
+export declare function writeSyncConfig(locations: SyncLocations, config: SyncConfig): Promise<void>;
+export declare function loadOverrides(locations: SyncLocations): Promise<Record<string, unknown> | null>;
+export declare function loadState(locations: SyncLocations): Promise<SyncState>;
+export declare function writeState(locations: SyncLocations, state: SyncState): Promise<void>;
+export declare function applyOverridesToRuntimeConfig(config: Record<string, unknown>, overrides: Record<string, unknown>): void;
+export declare function deepMerge<T>(base: T, override: unknown): T;
+export declare function stripOverrides(localConfig: Record<string, unknown>, overrides: Record<string, unknown>, baseConfig: Record<string, unknown> | null): Record<string, unknown>;
+export declare function parseJsonc<T>(content: string): T;
+export declare function writeJsonFile(filePath: string, data: unknown, options?: {
+    jsonc: boolean;
+    mode?: number;
+}): Promise<void>;

package/dist/sync/config.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sync/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class SyncError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class SyncConfigMissingError extends SyncError {
+    constructor(message: string);
+}
+export declare class RepoDivergedError extends SyncError {
+    constructor(message: string);
+}
+export declare class RepoPrivateRequiredError extends SyncError {
+    constructor(message: string);
+}
+export declare class RepoVisibilityError extends SyncError {
+    constructor(message: string);
+}
+export declare class SyncCommandError extends SyncError {
+    constructor(message: string);
+}

package/dist/sync/paths.d.ts

@@ -0,0 +1,47 @@
+import type { SyncConfig } from './config.ts';
+export interface XdgPaths {
+    homeDir: string;
+    configDir: string;
+    dataDir: string;
+    stateDir: string;
+}
+export interface SyncLocations {
+    xdg: XdgPaths;
+    configRoot: string;
+    syncConfigPath: string;
+    overridesPath: string;
+    statePath: string;
+    defaultRepoDir: string;
+}
+export type SyncItemType = 'file' | 'dir';
+export interface SyncItem {
+    localPath: string;
+    repoPath: string;
+    type: SyncItemType;
+    isSecret: boolean;
+    isConfigFile: boolean;
+}
+export interface ExtraSecretPlan {
+    allowlist: string[];
+    manifestPath: string;
+    entries: Array<{
+        sourcePath: string;
+        repoPath: string;
+    }>;
+}
+export interface SyncPlan {
+    items: SyncItem[];
+    extraSecrets: ExtraSecretPlan;
+    repoRoot: string;
+    homeDir: string;
+    platform: NodeJS.Platform;
+}
+export declare function resolveHomeDir(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): string;
+export declare function resolveXdgPaths(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): XdgPaths;
+export declare function resolveSyncLocations(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): SyncLocations;
+export declare function expandHome(inputPath: string, homeDir: string): string;
+export declare function normalizePath(inputPath: string, homeDir: string, platform?: NodeJS.Platform): string;
+export declare function isSamePath(left: string, right: string, homeDir: string, platform?: NodeJS.Platform): boolean;
+export declare function encodeSecretPath(inputPath: string): string;
+export declare function resolveRepoRoot(config: SyncConfig | null, locations: SyncLocations): string;
+export declare function buildSyncPlan(config: SyncConfig, locations: SyncLocations, repoRoot: string, platform?: NodeJS.Platform): SyncPlan;

package/dist/sync/paths.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sync/repo.d.ts

@@ -0,0 +1,31 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { SyncConfig } from './config.ts';
+export interface RepoStatus {
+    branch: string;
+    changes: string[];
+}
+export interface RepoUpdateResult {
+    updated: boolean;
+    branch: string;
+}
+type Shell = PluginInput['$'];
+export declare function isRepoCloned(repoDir: string): Promise<boolean>;
+export declare function resolveRepoIdentifier(config: SyncConfig): string;
+export declare function resolveRepoBranch(config: SyncConfig, fallback?: string): string;
+export declare function ensureRepoCloned($: Shell, config: SyncConfig, repoDir: string): Promise<void>;
+export declare function ensureRepoPrivate($: Shell, config: SyncConfig): Promise<void>;
+export declare function parseRepoVisibility(output: string): boolean;
+export declare function fetchAndFastForward($: Shell, repoDir: string, branch: string): Promise<RepoUpdateResult>;
+export declare function getRepoStatus($: Shell, repoDir: string): Promise<RepoStatus>;
+export declare function hasLocalChanges($: Shell, repoDir: string): Promise<boolean>;
+export declare function commitAll($: Shell, repoDir: string, message: string): Promise<void>;
+export declare function pushBranch($: Shell, repoDir: string, branch: string): Promise<void>;
+export declare function repoExists($: Shell, repoIdentifier: string): Promise<boolean>;
+export declare function getAuthenticatedUser($: Shell): Promise<string>;
+export interface FoundRepo {
+    owner: string;
+    name: string;
+    isPrivate: boolean;
+}
+export declare function findSyncRepo($: Shell, repoName?: string): Promise<FoundRepo | null>;
+export {};

package/dist/sync/repo.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/sync/service.d.ts

@@ -0,0 +1,31 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+type SyncServiceContext = Pick<PluginInput, 'client' | '$'>;
+interface InitOptions {
+    repo?: string;
+    owner?: string;
+    name?: string;
+    url?: string;
+    branch?: string;
+    includeSecrets?: boolean;
+    includeSessions?: boolean;
+    includePromptStash?: boolean;
+    create?: boolean;
+    private?: boolean;
+    extraSecretPaths?: string[];
+    localRepoPath?: string;
+}
+interface LinkOptions {
+    repo?: string;
+}
+export interface SyncService {
+    startupSync: () => Promise<void>;
+    status: () => Promise<string>;
+    init: (_options: InitOptions) => Promise<string>;
+    link: (_options: LinkOptions) => Promise<string>;
+    pull: () => Promise<string>;
+    push: () => Promise<string>;
+    enableSecrets: (_extraSecretPaths?: string[]) => Promise<string>;
+    resolve: () => Promise<string>;
+}
+export declare function createSyncService(ctx: SyncServiceContext): SyncService;
+export {};

package/dist/sync/utils.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInput } from '@opencode-ai/plugin';
+type Client = PluginInput['client'];
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function createLogger(client: Client): {
+    debug: (message: string, extra?: Record<string, unknown>) => void;
+    info: (message: string, extra?: Record<string, unknown>) => void;
+    warn: (message: string, extra?: Record<string, unknown>) => void;
+    error: (message: string, extra?: Record<string, unknown>) => void;
+};
+export declare function showToast(client: Client, message: string, variant: 'info' | 'success' | 'warning' | 'error'): Promise<void>;
+export declare function unwrapData<T>(response: unknown): T | null;
+export declare function extractTextFromResponse(response: unknown): string | null;
+export declare function resolveSmallModel(client: Client): Promise<{
+    providerID: string;
+    modelID: string;
+} | null>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-synced",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Sync global OpenCode config across machines via GitHub.",
   "author": {
     "name": "Ian Hildebrand"