@frankzhang2026/opencode-android-orchestrator 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## Unreleased
+
+- Create the initial private TypeScript/npm plugin scaffold.

package/README.md

@@ -0,0 +1,25 @@
+# OpenCode Android Orchestrator
+
+Reusable OpenCode orchestration for macOS Android projects.
+
+## Status
+
+This repository currently contains only the TypeScript/npm scaffold. The
+installer lifecycle and the verified Android orchestration V3 templates have
+not been migrated yet. The package metadata is configured for public
+publication under the `@frankzhang2026` npm scope.
+
+## Planned usage
+
+```sh
+npx @frankzhang2026/opencode-android-orchestrator@0.1.0 init .
+opencode --agent scheduled-planner .
+```
+
+## Development
+
+```sh
+npm run typecheck
+npm test
+npm run pack:check
+```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { INSTALLER_COMMANDS } from "./commands/index.js";
+function printHelp() {
+    process.stdout.write(`OpenCode Android Orchestrator\n\n`);
+    process.stdout.write(`Usage:\n`);
+    process.stdout.write(`  opencode-android-orchestrator <command> [directory]\n\n`);
+    process.stdout.write(`Commands:\n`);
+    process.stdout.write(`  init       Install project-local orchestration resources\n`);
+    process.stdout.write(`  doctor     Diagnose an existing installation\n`);
+    process.stdout.write(`  upgrade    Upgrade unchanged managed resources\n`);
+    process.stdout.write(`  uninstall  Remove unchanged managed resources\n`);
+}
+const [command] = process.argv.slice(2);
+if (command === undefined || command === "--help" || command === "-h") {
+    printHelp();
+}
+else if (INSTALLER_COMMANDS.includes(command)) {
+    process.stderr.write(`Command "${command}" is scaffolded but not implemented yet.\n`);
+    process.exitCode = 1;
+}
+else {
+    process.stderr.write(`Unknown command: ${command}\n\n`);
+    printHelp();
+    process.exitCode = 2;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAC1D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAClF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAExC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;IACtE,SAAS,EAAE,CAAC;AACd,CAAC;KAAM,IAAK,kBAAwC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,YAAY,OAAO,4CAA4C,CAChE,CAAC;IACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC;KAAM,CAAC;IACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,MAAM,CAAC,CAAC;IACxD,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/index.d.ts

@@ -0,0 +1,2 @@
+export declare const INSTALLER_COMMANDS: readonly ["init", "doctor", "upgrade", "uninstall"];
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,qDAKrB,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,7 @@
+export const INSTALLER_COMMANDS = [
+    "init",
+    "doctor",
+    "upgrade",
+    "uninstall",
+];
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM;IACN,QAAQ;IACR,SAAS;IACT,WAAW;CACH,CAAC"}

package/dist/compatibility/versions.d.ts

@@ -0,0 +1,4 @@
+export declare const MINIMUM_OPENCODE_VERSION = "1.14.22";
+export declare const MAXIMUM_OPENCODE_VERSION = "1.16.0";
+export declare const CERTIFIED_OPENCODE_VERSIONS: readonly ["1.14.22", "1.15.13"];
+//# sourceMappingURL=versions.d.ts.map

package/dist/compatibility/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAClD,eAAO,MAAM,wBAAwB,WAAW,CAAC;AACjD,eAAO,MAAM,2BAA2B,iCAAkC,CAAC"}

package/dist/compatibility/versions.js

@@ -0,0 +1,4 @@
+export const MINIMUM_OPENCODE_VERSION = "1.14.22";
+export const MAXIMUM_OPENCODE_VERSION = "1.16.0";
+export const CERTIFIED_OPENCODE_VERSIONS = ["1.14.22", "1.15.13"];
+//# sourceMappingURL=versions.js.map

package/dist/compatibility/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","sourceRoot":"","sources":["../../src/compatibility/versions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAClD,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AACjD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAS,EAAE,SAAS,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { AndroidOrchestratorPlugin, default } from "./plugin/index.js";
+export { CERTIFIED_OPENCODE_VERSIONS, MAXIMUM_OPENCODE_VERSION, MINIMUM_OPENCODE_VERSION, } from "./compatibility/versions.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { AndroidOrchestratorPlugin, default } from "./plugin/index.js";
+export { CERTIFIED_OPENCODE_VERSIONS, MAXIMUM_OPENCODE_VERSION, MINIMUM_OPENCODE_VERSION, } from "./compatibility/versions.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC"}

package/dist/installer/index.d.ts

@@ -0,0 +1,6 @@
+export type InstallerCommand = "init" | "doctor" | "upgrade" | "uninstall";
+export interface InstallerRequest {
+    command: InstallerCommand;
+    targetDirectory: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/installer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE3E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/installer/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/installer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/installer/index.ts"],"names":[],"mappings":""}

package/dist/plugin/index.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * Minimal, side-effect-free plugin entry used while the installer and
+ * read-only diagnostic tools are implemented.
+ */
+export declare const AndroidOrchestratorPlugin: Plugin;
+export default AndroidOrchestratorPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAQvC,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,11 @@
+/**
+ * Minimal, side-effect-free plugin entry used while the installer and
+ * read-only diagnostic tools are implemented.
+ */
+export const AndroidOrchestratorPlugin = async ({ directory, worktree, }) => {
+    void directory;
+    void worktree;
+    return {};
+};
+export default AndroidOrchestratorPlugin;
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAW,KAAK,EAAE,EACtD,SAAS,EACT,QAAQ,GACT,EAAE,EAAE;IACH,KAAK,SAAS,CAAC;IACf,KAAK,QAAQ,CAAC;IAEd,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@frankzhang2026/opencode-android-orchestrator",
+  "version": "0.1.0",
+  "description": "Reusable OpenCode orchestration for Android projects",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "opencode-android-orchestrator": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test tests/*.test.mjs",
+    "pack:check": "npm pack --dry-run",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "android",
+    "automation",
+    "orchestration"
+  ],
+  "author": "",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.14.22 <1.16.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "1.14.22",
+    "@types/node": "22.13.9",
+    "typescript": "5.8.2"
+  }
+}

package/templates/README.md

@@ -0,0 +1,14 @@
+# Installation templates
+
+This directory will contain the project-local OpenCode resources extracted
+from the verified Android orchestration V3 baseline.
+
+Planned template roots:
+
+- `.opencode/agents`, `.opencode/commands`, and `.opencode/skills`
+- `automation` configuration, schemas, and the task contract example
+- `scripts/automation` deterministic shell transactions
+- `docs/plans/README.md`
+
+Historical tasks, runtime evidence, backups, Android product code, and local
+absolute paths must never be included.