opencode-pair-autonomy 1.0.0

package/dist/installer.d.ts

@@ -0,0 +1,12 @@
+export declare function installHarness(options?: {
+    fresh?: boolean;
+}): Promise<{
+    configPath: string;
+    packageJsonPath: string;
+    harnessConfigPath: string;
+}>;
+export declare function uninstallHarness(): Promise<{
+    configPath: string;
+    packageJsonPath: string;
+    preservedPaths: string[];
+}>;

package/dist/learning/analyzer.d.ts

@@ -0,0 +1,15 @@
+import type { PersistedSessionSummary, Observation } from "../hooks/runtime";
+import { type ProjectFacts } from "../project-facts";
+import type { LearningEvidence, LearnedPattern } from "./types";
+export declare function promoteLearnedPatterns(params: {
+    existing: LearnedPattern[];
+    summary: PersistedSessionSummary;
+    facts: ProjectFacts;
+    observations: Observation[];
+    maxPatterns: number;
+}): LearnedPattern[];
+export declare function renderPatternKind(kind: LearnedPattern["kind"]): string;
+export declare function renderPatternHeading(kind: LearnedPattern["kind"]): string;
+export declare function renderPatternEvidence(evidence: LearningEvidence): string;
+export declare function renderInjectedPatterns(patterns: LearnedPattern[], limit: number): string[];
+export declare function getPatternSummary(pattern: LearnedPattern): string;

package/dist/learning/store.d.ts

@@ -0,0 +1,4 @@
+import type { LearningArtifact, LearnedPattern } from "./types";
+export declare function loadLearningArtifact(filePath: string): LearningArtifact;
+export declare function saveLearningArtifact(filePath: string, patterns: LearnedPattern[]): void;
+export declare function saveLearningMarkdown(filePath: string, patterns: LearnedPattern[]): void;

package/dist/learning/types.d.ts

@@ -0,0 +1,32 @@
+export type LearnedPatternKind = "user_preference" | "repo_convention" | "workflow_rule" | "failure_pattern" | "tooling_pattern";
+export type LearningEvidence = string | {
+    text?: string;
+    messageKey?: string;
+    values?: Record<string, string | number>;
+};
+export type LearnedPattern = {
+    id: string;
+    kind: LearnedPatternKind;
+    summary?: string;
+    summaryKey?: string;
+    summaryValues?: Record<string, string | number>;
+    confidence: number;
+    occurrences: number;
+    firstSeen: string;
+    lastSeen: string;
+    evidence: LearningEvidence[];
+    source: "automatic" | "manual";
+};
+export type LearningArtifact = {
+    updatedAt: string;
+    patterns: LearnedPattern[];
+};
+export type LearningCandidate = {
+    id: string;
+    kind: LearnedPatternKind;
+    summary?: string;
+    summaryKey?: string;
+    summaryValues?: Record<string, string | number>;
+    evidence: LearningEvidence;
+    baseConfidence: number;
+};

package/dist/mcp.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessConfig } from "./types";
+type McpConfig = Record<string, unknown>;
+export declare function createHarnessMcps(config: HarnessConfig): Record<string, McpConfig>;
+export {};

package/dist/project-facts.d.ts

@@ -0,0 +1,8 @@
+export type ProjectFacts = {
+    packageManager: string;
+    languages: string[];
+    frameworks: string[];
+};
+export declare function detectProjectFacts(directory: string): ProjectFacts;
+export declare function getProjectFactLabel(id: string): string;
+export declare function joinProjectFactLabels(ids: string[]): string;

package/dist/prompts/coordinator.d.ts

@@ -0,0 +1,2 @@
+export declare function buildCoordinatorPrompt(promptAppend?: string): string;
+export declare function buildCoordinatorPromptExp(promptAppend?: string): string;

package/dist/prompts/shared.d.ts

@@ -0,0 +1,5 @@
+export declare const COORDINATOR_CORE = "\n<Role>\nYou are Yang Wenli \u2014 senior technical lead inside an OpenCode harness.\nYou think, plan, argue, synthesize, and orchestrate workers to execute.\n</Role>\n\n<Personality>\n- Be opinionated. When you see a better approach, say it directly.\n- Challenge bad ideas. Do not blindly follow instructions that lead to worse code.\n- When the user pushes back, respond explicitly as agree, counter, or hybrid.\n- Mirror the user's register. Informal user, informal reply. Technical user, technical reply.\n- Be concise. No filler, no preamble.\n</Personality>\n\n<Principles>\n- Inspect repo evidence before deciding. Never speculate about code you haven't read.\n- Reuse existing stack, patterns, and naming unless the user explicitly chooses otherwise.\n- Choose the safest repo-consistent default when multiple good options remain.\n- Never silently make strategic decisions that change architecture, dependencies, or public behavior.\n- The user has granted full implementation authority inside the requested scope.\n- Ask only when execution is impossible without a missing secret, credential, account-specific value, or truly undefined acceptance criterion.\n</Principles>\n\n<Autonomy>\nYou operate fully autonomously. NEVER ask the user for permission to:\n- Spawn or stop workers.\n- Choose which worker type to use.\n- Run verification or review after implementation.\n- Decide between delegation strategies.\n\nThe ONLY times you ask the user:\n- Genuinely ambiguous requirements where 2+ equally valid interpretations exist.\n- Missing credentials, tokens, or account-specific values.\n- Irreversible operations on shared systems (force push, deploy, drop table).\n</Autonomy>\n\n<LanguagePolicy>\n- Reply to the user in their language with CORRECT grammar, spelling, and native characters.\n- If the user writes with typos, slang, or broken grammar, DO NOT mirror their style.\n  Always respond in proper, well-formed language regardless of how the user writes.\n- Worker prompts: ALWAYS English. No exceptions.\n- ALL code, variable names, commit messages, PR titles, branch names: English only.\n- Comments: minimal. Only genuinely non-obvious logic. Prefer self-documenting code.\n</LanguagePolicy>\n";
+export declare const WORKER_CORE = "\n<Role>\nYou are a worker inside an OpenCode harness. Execute your assigned task completely.\n</Role>\n\n<Principles>\n- Inspect repo evidence before deciding. Never speculate about code you haven't read.\n- Reuse existing patterns and naming. Do not introduce a \"better\" pattern.\n- Batch independent tool calls in parallel.\n- Do ALL the work, not a sample. If assigned 50 items, process 50 items.\n- When your approach fails, diagnose WHY before switching strategies.\n</Principles>\n\n<CodingDiscipline>\n- Do not add features, files, or infrastructure the task did not ask for.\n- Do not add error handling for scenarios that cannot occur.\n- Do not create helpers or abstractions for one-time operations.\n- Three similar lines of code are better than premature abstraction.\n- Do not add comments to unchanged code. Only comment genuinely non-obvious logic.\n- Prefer self-documenting code. Comments should explain \"why\", never \"what\".\n- Be careful not to introduce OWASP top 10 vulnerabilities.\n- When editing code, preserve surrounding style exactly (indentation, quotes, semicolons).\n- ALWAYS prefer editing existing files over creating new ones.\n</CodingDiscipline>\n\n<ToolGuidance>\n- Read a file before editing it. Edit will fail if you haven't read first.\n- Prefer Edit over Write for modifications. Edit sends only the diff.\n- Prefer dedicated tools over Bash equivalents:\n  File search: Glob (not find). Content search: Grep (not grep/rg).\n  Read files: Read (not cat/head/tail). Edit files: Edit (not sed/awk).\n  Write files: Write (not echo).\n- For git: prefer new commits over amend. Never skip hooks. Never force push without explicit request.\n- For Bash: use absolute paths, avoid cd, quote paths with spaces, chain with && not newlines.\n- Batch independent tool calls in parallel.\n</ToolGuidance>\n\n<BeforeBuilding>\nBEFORE writing ANY new code:\n1. Search for existing implementations: Glob, Grep for the relevant keywords.\n2. Read 2-3 similar files in the same directory to learn the pattern.\n3. If existing implementation found, extend it. Do not rewrite from scratch.\n4. If new approach needed, research constraints FIRST (docs, API limits).\nNEVER propose \"build from scratch\" when existing code might already solve the problem.\n</BeforeBuilding>\n\n<SanityChecks>\nAfter computing any value, verify it makes sense:\n- Percentages: 0-100 range. If > 100, your denominator is wrong.\n- Counts: never negative.\n- Dates: not in the future unless intended.\n- Arrays: check length > 0 before accessing index 0.\nAfter modifying a table or grid:\n- Count headers must equal count data cells per row.\n- Verify every header has corresponding data and vice versa.\n</SanityChecks>\n\n<Reporting>\nWhen done, report concisely:\n- What was done (files changed, commits made).\n- Key findings or decisions.\n- Any blockers, open questions, or concerns.\n- Relevant file paths and line numbers.\nThe coordinator will synthesize your report for the user. Keep it factual and compact.\nIf you cannot proceed, report: \"BLOCKER: {reason}\" so the coordinator can relay to the user.\n</Reporting>\n\n<LanguagePolicy>\n- ALL code, comments, variable names, commit messages MUST be in English.\n- Reports to coordinator in English.\n</LanguagePolicy>\n";
+export declare const RESPONSE_DISCIPLINE = "\n<ResponseStyle>\n- Open with substance, not filler.\n- Keep structure proportional to the task.\n- Do not narrate obvious tool usage.\n- End with a concrete next step or concise result summary.\n- Match the user's brevity. Short question, short answer.\n- Avoid AI-slop phrases: \"Great question!\", \"Certainly!\", \"Let me...\", \"I'd be happy to...\".\n- Do not restate what the user just said. Do not add preamble.\n</ResponseStyle>\n\n<CorrectionProtocol>\nWhen the user corrects you or pushes back:\n- Adapt IMMEDIATELY. Do not defend, justify, or explain why you did it the old way.\n- If corrected twice on the same issue, treat it as a hard constraint for the session.\n- When the user says \"no\" or redirects, stop the current approach entirely.\n- Track scope changes: \"fix this button\" expanding to \"review the whole page\" means the new scope is the real scope.\n</CorrectionProtocol>\n\n<AntiPatterns>\nNEVER do these:\n- Add features, files, CI/CD, tests, or infrastructure the user did not ask for.\n- Suggest technology migrations or wholesale rewrites unprompted.\n- Do a sample of the work instead of all of it.\n- Write credentials or secrets to files.\n- Assume which project, file, or context the user means. If ambiguous, ask.\n</AntiPatterns>\n\n<ResearchAccuracy>\nWhen doing research, calculations, or data lookup:\n- Use REAL data from the web. Do not estimate or hallucinate numbers.\n- Cross-validate claims across multiple sources. If sources disagree, say so.\n</ResearchAccuracy>\n";
+export declare function buildMcpCatalog(): string;
+export declare function withPromptAppend(prompt: string, promptAppend?: string): string;

package/dist/prompts/workers.d.ts

@@ -0,0 +1,8 @@
+export declare function buildWorkerPrompt(promptAppend?: string): string;
+export declare function buildResearcherPrompt(promptAppend?: string): string;
+export declare function buildReviewerPrompt(promptAppend?: string): string;
+export declare function buildYetAnotherReviewerPrompt(promptAppend?: string): string;
+export declare function buildVerifierPrompt(promptAppend?: string): string;
+export declare function buildRepairPrompt(promptAppend?: string): string;
+export declare function buildUiDeveloperPrompt(promptAppend?: string): string;
+export declare function buildRepoScoutPrompt(promptAppend?: string): string;

package/dist/types.d.ts

@@ -0,0 +1,81 @@
+export type HarnessMode = "coordinator";
+export type PlanModeState = "planning" | "executing";
+export type WorkerType = "thorfinn" | "ginko" | "kaiki" | "odokawa" | "ozen" | "skull-knight" | "paprika" | "rajdhani";
+export type HookProfile = "minimal" | "standard" | "strict";
+export type WslState = {
+    enabled: boolean;
+    winDrive: string;
+    winProjectPath: string;
+};
+export type ResourceMap = {
+    sshHosts: string[];
+    dbConnections: {
+        mariadb: string[];
+        postgres: string[];
+    };
+    projectDocs: string[];
+    skills: string[];
+};
+export type McpToggles = {
+    context7?: boolean;
+    grep_app?: boolean;
+    websearch?: boolean;
+    fff?: boolean;
+    web_agent_mcp?: boolean;
+    pg_mcp?: boolean;
+    ssh_mcp?: boolean;
+    sudo_mcp?: boolean;
+    jina?: boolean;
+    figma_console?: boolean;
+    mariadb?: boolean;
+};
+export type FigmaConsoleConfig = {
+    ssh_host?: string;
+};
+export type AgentOverride = {
+    model?: string;
+    variant?: string;
+    description?: string;
+    prompt_append?: string;
+};
+export type HarnessConfig = {
+    default_mode?: HarnessMode;
+    set_default_agent?: boolean;
+    commands?: {
+        enabled?: boolean;
+    };
+    credentials?: {
+        jina_api_key?: string;
+        figma_access_token?: string;
+    };
+    figma_console?: FigmaConsoleConfig;
+    hooks?: {
+        profile?: HookProfile;
+        comment_guard?: boolean;
+        session_start?: boolean;
+        pre_tool_use?: boolean;
+        post_tool_use?: boolean;
+        pre_compact?: boolean;
+        stop?: boolean;
+        session_end?: boolean;
+        file_edited?: boolean;
+        prompt_refiner?: boolean;
+    };
+    memory?: {
+        enabled?: boolean;
+        directory?: string;
+        lookback_days?: number;
+        max_injected_chars?: number;
+    };
+    learning?: {
+        enabled?: boolean;
+        directory?: string;
+        min_observations?: number;
+        auto_promote?: boolean;
+        max_patterns?: number;
+        max_injected_patterns?: number;
+    };
+    mcps?: McpToggles;
+    agents?: Record<string, AgentOverride>;
+};
+export type AgentLike = Record<string, unknown>;

package/dist/utils.d.ts

@@ -0,0 +1,6 @@
+export declare function isObject(value: unknown): value is Record<string, unknown>;
+export declare function deepMerge<T>(base: T, override: unknown): T;
+export declare function ensureDir(dirPath: string): void;
+export declare function readJson<T>(filePath: string, fallback: T): T;
+export declare function writeJson(filePath: string, value: unknown): void;
+export declare function readText(filePath: string): string | undefined;

package/examples/opencode-pair-autonomy.jsonc

@@ -0,0 +1,35 @@
+{
+  "default_mode": "coordinator",
+  "set_default_agent": true,
+  "hooks": {
+    "intent_gate": false,
+    "todo_continuation": true,
+    "comment_guard": true,
+    "flush_queued_prompts": true,
+    "todo_continuation_cooldown_ms": 30000
+  },
+  "mcps": {
+    "context7": true,
+    "grep_app": true,
+    "websearch": true,
+    "chrome_devtools": true,
+    "pg_mcp": true,
+    "ssh_mcp": true,
+    "sudo_mcp": true,
+    "jina": true
+  },
+  "agents": {
+    "ryo": {
+      "variant": "high"
+    },
+    "shounen-bat": {
+      "model": "kimi-for-coding/k2p5"
+    },
+    "eiri": {
+      "model": "kimi-for-coding/k2p5"
+    },
+    "bondrewd": {
+      "model": "kimi-for-coding/k2p5"
+    }
+  }
+}

package/examples/opencode.jsonc

@@ -0,0 +1,17 @@
+{
+  // Reference example for the plugin stack after installation.
+  "plugin": [
+    "opencode-pair-autonomy",
+    "opencode-pty",
+    "opencode-notificator",
+    "@zenobius/opencode-skillful",
+    "file:///ABSOLUTE/PATH/TO/opencode-background-agents-local",
+    "@tarquinen/opencode-dcp",
+    "@franlol/opencode-md-table-formatter",
+    "opencode-anthropic-login-via-cli"
+  ],
+  "instructions": [
+    "~/.config/opencode/plugin/shell-strategy/shell_strategy.md"
+  ],
+  "default_agent": "pair"
+}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "opencode-pair-autonomy",
+  "version": "1.0.0",
+  "description": "OpenCode harness with opinionated agent orchestration. One coordinator, eight specialized workers, automatic verify+review pipeline.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "opencode-pair-autonomy": "bin/opencode-pair-autonomy.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "vendor",
+    "examples",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && bun build src/cli.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
+    "clean": "rm -rf dist",
+    "prepare": "bun run build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "agent",
+    "harness",
+    "orchestration",
+    "pair-programming"
+  ],
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "releaseRules": [
+            {
+              "type": "refactor",
+              "release": "patch"
+            },
+            {
+              "type": "perf",
+              "release": "patch"
+            },
+            {
+              "type": "test",
+              "release": "patch"
+            },
+            {
+              "type": "chore",
+              "scope": "deps",
+              "release": "patch"
+            }
+          ]
+        }
+      ],
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/npm",
+      [
+        "@semantic-release/github",
+        {
+          "assets": [
+            {
+              "path": "release-binaries/opencode-pair-autonomy-linux-x64",
+              "label": "CLI Binary (Linux x64)"
+            },
+            {
+              "path": "release-binaries/opencode-pair-autonomy-linux-arm64",
+              "label": "CLI Binary (Linux ARM64)"
+            },
+            {
+              "path": "release-binaries/opencode-pair-autonomy-darwin-x64",
+              "label": "CLI Binary (macOS x64)"
+            },
+            {
+              "path": "release-binaries/opencode-pair-autonomy-darwin-arm64",
+              "label": "CLI Binary (macOS ARM64)"
+            }
+          ]
+        }
+      ]
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cemalturkcan/oh-my-pair-code.git"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "latest",
+    "jsonc-parser": "^3.3.1",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "bun-types": "1.3.6",
+    "typescript": "^5.7.3"
+  }
+}

package/vendor/mcp/pg-mcp/README.md

@@ -0,0 +1,91 @@
+# PostgreSQL MCP Server (stdio)
+
+Bu proje, PostgreSQL icin basit bir MCP sunucusu saglar. Iletisim `stdio` uzerinden yapilir ve sorgular salt-okunur sekilde calisir.
+
+## Ozellikler
+
+- `config.json` ile birden fazla baglanti tanimi
+- MCP araclari:
+  - `list_connections`
+  - `list_databases`
+  - `list_schemas`
+  - `list_tables`
+  - `describe_table`
+  - `execute_select`
+- Istege bagli `database` parametresi ile tek baglanti uzerinden farkli DB'leri gezebilme
+- Guvenlik kurallari:
+  - Yalnizca `SELECT` sorgulari
+  - Coklu statement reddi
+  - Yazma/DDL anahtar kelimeleri reddi
+  - Read-only transaction
+  - `statement_timeout` zorlamasi
+  - Baglanti bazli satir limiti (`default_row_limit` / `max_row_limit`)
+
+## Kurulum
+
+```bash
+npm install
+```
+
+## Yapilandirma
+
+1. Ornek dosyayi kopyalayin:
+
+```bash
+cp config.example.json config.json
+```
+
+2. `config.json` icindeki baglanti bilgilerini guncelleyin.
+
+Notlar:
+- Gercek `config.json` dosyasi `.gitignore` ile dislanmistir.
+- Dilerseniz farkli bir yol kullanmak icin `PG_MCP_CONFIG_PATH` degiskenini ayarlayabilirsiniz.
+
+## Calistirma
+
+```bash
+npm start
+```
+
+## Ornek MCP istemci ayari
+
+Asagidaki ornek, MCP istemci konfigine bu sunucuyu eklemek icindir:
+
+```json
+{
+  "mcpServers": {
+    "pg": {
+      "command": "node",
+      "args": ["/absolute/path/to/pg-mcp/src/index.js"],
+      "env": {
+        "PG_MCP_CONFIG_PATH": "/absolute/path/to/pg-mcp/config.json"
+      }
+    }
+  }
+}
+```
+
+## Baglanti ayari (ornek)
+
+```json
+{
+  "connections": {
+    "local": {
+      "host": "127.0.0.1",
+      "port": 5432,
+      "user": "readonly_user",
+      "password": "readonly_password",
+      "database": "postgres",
+      "description": "Root baglanti (DB listesi icin)",
+      "statement_timeout_ms": 10000,
+      "default_row_limit": 100,
+      "max_row_limit": 1000
+    }
+  }
+}
+```
+
+## DB gezme akisi
+
+1. `list_databases` ile erisilebilir DB'leri alin.
+2. `list_schemas` / `list_tables` / `describe_table` / `execute_select` cagrilarinda `database` parametresi gonderin.

package/vendor/mcp/pg-mcp/config.example.json

@@ -0,0 +1,26 @@
+{
+  "connections": {
+    "local": {
+      "host": "127.0.0.1",
+      "port": 5432,
+      "user": "readonly_user",
+      "password": "readonly_password",
+      "database": "app_db",
+      "description": "Yerel gelistirme veritabani",
+      "statement_timeout_ms": 10000,
+      "default_row_limit": 100,
+      "max_row_limit": 1000
+    },
+    "staging": {
+      "host": "staging-db.example.com",
+      "port": 5432,
+      "user": "readonly_staging",
+      "password": "staging_password",
+      "database": "app_staging",
+      "description": "Staging ortami",
+      "statement_timeout_ms": 8000,
+      "default_row_limit": 50,
+      "max_row_limit": 500
+    }
+  }
+}

package/vendor/mcp/pg-mcp/config.json

@@ -0,0 +1,15 @@
+{
+  "connections": {
+    "local": {
+      "host": "127.0.0.1",
+      "port": 5432,
+      "user": "postgres",
+      "password": "",
+      "database": "postgres",
+      "description": "Local PostgreSQL (read-only expected)",
+      "statement_timeout_ms": 10000,
+      "default_row_limit": 100,
+      "max_row_limit": 1000
+    }
+  }
+}