mednotes-opencode 0.1.0 → 0.1.1

package/.opencode/mednotes/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "medical-notes-workbench",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "medical-notes-workbench",
-      "version": "0.1.0",
+      "version": "0.1.1",
       "dependencies": {
         "mddb": "^0.9.5"
       },

package/.opencode/mednotes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medical-notes-workbench",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Gemini CLI extension packaging for medical notes creation and processing.",
   "private": true,
   "engines": {

package/.opencode/mednotes/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "medical-notes-workbench"
-version = "0.1.0"
+version = "0.1.1"
 description = "Workbench para criar, enriquecer e processar notas médicas Markdown/Obsidian."
 requires-python = ">=3.11"
 dependencies = [

package/.opencode/mednotes.generated.json

@@ -51,9 +51,9 @@
     ".opencode/mednotes/docs/vocabulary-db-recovery.md": "sha256:8182d3b064cd81576f5f471b4db526f17a37b43b3c5f2a509fb4d56685cd54e4",
     ".opencode/mednotes/docs/workflow-output-contract.md": "sha256:a3e12d90fad21ec9ba068b7b83903dee4219f704687ecdad7fd7510ab591cfb7",
     ".opencode/mednotes/hooks/hooks.json": "sha256:8645faf10794e8a2ac06a54d7ba703872c2fe15f5d4ea7e64b58f60074951009",
-    ".opencode/mednotes/package-lock.json": "sha256:33d8543fb19d9eff8b5d3b0da86b569b1ff007c2d6c90ca449b018aa6437d815",
-    ".opencode/mednotes/package.json": "sha256:c286968311caadaa1f6a3f9ed0ecf5b37b4661d4e10d668521e7aa6df72489cb",
-    ".opencode/mednotes/pyproject.toml": "sha256:c0a843c3bbdd7878987485a780aa7de5a7ef4140f486f8888552ceb11ba48b4f",
+    ".opencode/mednotes/package-lock.json": "sha256:add5fedbfaaffbd580e71a6ac8a3d7fa527c5d1b73ee4da723e747d90a92b0b6",
+    ".opencode/mednotes/package.json": "sha256:6284bec4738bf3c20f17fbd3c359da6df0684656074169a1d49867f666030aed",
+    ".opencode/mednotes/pyproject.toml": "sha256:f56ccec981f2433777771303a5f9f50947ed0f0883e93d6ca279e1c28e432a45",
     ".opencode/mednotes/scripts/bootstrap_windows_python_uv.cmd": "sha256:7ed23e9086b84aa161439a20814930d8d93c7dc3c7b77d9818477ef6690db3d3",
     ".opencode/mednotes/scripts/bootstrap_windows_python_uv.ps1": "sha256:148a5eada17bc4a2a395eddb3019d437b93429730d75f8962907a24492d8770e",
     ".opencode/mednotes/scripts/enrich_notes.py": "sha256:68eae00f72cf1b4b93989f29397f0fe0dea510ae25d76131489428d86e77f380",

package/README.md

@@ -11,63 +11,39 @@ hashes, recibos e validações, mas a experiência humana deve parecer direta.
 
 ## Instalação
 
-Enquanto o pacote `mednotes-opencode` ainda não estiver publicado no registry
-npm, instale pelo repo público GitHub:
-
-```bash
-npm install -g github:augustocaruso/mednotes
-```
-
-Registre o plugin no OpenCode apontando para o mesmo spec GitHub:
-
-```bash
-mednotes-opencode install --plugin github:augustocaruso/mednotes
-```
-
-Quando o pacote npm estiver publicado, o caminho equivalente pelo registry será:
+Instale pelo pacote npm público:
 
 ```bash
 npm install -g mednotes-opencode
 ```
 
-E o registro do plugin poderá usar o spec curto:
+Registre a superfície MedNotes no OpenCode:
 
 ```bash
 mednotes-opencode install
 ```
 
-Esse comando atualiza `~/.config/opencode/opencode.json` no macOS/Linux, ou o
-caminho equivalente em `%APPDATA%` no Windows. Ele cria backup antes de alterar
-um arquivo existente e pode ser auditado sem escrever nada:
+Esse comando instala comandos, agentes, runtime e hook em
+`~/.config/opencode` no macOS/Linux, ou no caminho equivalente em `%APPDATA%`
+no Windows. Ele mescla `opencode.json`, cria backup antes de alterar um arquivo
+existente e pode ser auditado sem escrever nada:
 
 ```bash
 mednotes-opencode install --dry-run
 ```
 
 Depois disso, abra o OpenCode normalmente. O plugin é carregado pelo próprio
-OpenCode como pacote npm/GitHub e sincroniza a configuração de runtime no boot.
+OpenCode a partir do arquivo local instalado em `plugins/mednotes-fsm.mjs` e
+sincroniza a configuração de runtime no boot.
 
 ## Atualização
 
-Se instalado pelo GitHub, atualize reinstalando o spec público:
-
-```bash
-npm install -g github:augustocaruso/mednotes
-mednotes-opencode install --plugin github:augustocaruso/mednotes
-```
-
-Quando o pacote registry estiver publicado, atualize como qualquer pacote npm:
+Atualize como qualquer pacote npm e rode o instalador novamente para copiar a
+nova superfície gerada para o diretório de configuração do OpenCode:
 
 ```bash
 npm update -g mednotes-opencode
-```
-
-Se o `opencode.json` usar o spec `mednotes-opencode`, o OpenCode também pode
-resolver versões novas pelo mecanismo nativo de plugins npm. Para congelar uma
-versão, use um spec com versão explícita no instalador:
-
-```bash
-mednotes-opencode install --plugin mednotes-opencode@0.1.0
+mednotes-opencode install
 ```
 
 ## Configuração
@@ -149,7 +125,9 @@ O pacote npm exporta o plugin OpenCode por:
 
 Arquivos principais:
 
-- `.opencode/`: plugin, agentes, comandos e runtime OpenCode gerados.
+- `.opencode/`: plugin, agentes, comandos e runtime OpenCode gerados. O
+  instalador copia essa superfície para o diretório de configuração do
+  OpenCode sem sobrescrever a configuração inteira do usuário.
 - `core/`: fontes canônicas públicas de agentes, comandos e skills.
 - `contracts/`: contratos de agentes usados pelos geradores.
 - `adapters/`: projeções secundárias mantidas por compatibilidade.

package/adapters/gemini-cli/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "medical-notes-workbench",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Gemini CLI workbench for creating, organizing, and processing medical Markdown notes for Obsidian.",
   "contextFileName": "GEMINI.md",
   "settings": [

package/adapters/gemini-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medical-notes-workbench",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Gemini CLI extension packaging for medical notes creation and processing.",
   "private": true,
   "engines": {

package/adapters/gemini-cli/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "medical-notes-workbench"
-version = "0.1.0"
+version = "0.1.1"
 description = "Workbench para criar, enriquecer e processar notas médicas Markdown/Obsidian."
 requires-python = ">=3.11"
 dependencies = [

package/bin/mednotes-opencode.mjs

@@ -1,11 +1,35 @@
 #!/usr/bin/env node
 import { existsSync } from "node:fs";
-import { copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { copyFile, cp, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const PACKAGE_SPEC = "mednotes-opencode";
 const OPENCODE_SCHEMA = "https://opencode.ai/config.json";
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const PACKAGE_OPENCODE = findPackagedOpenCodeDir();
+const GENERATED_CONFIG = path.join(PACKAGE_OPENCODE, "opencode.json");
+const MEDNOTES_RUNTIME_REF = ".opencode/mednotes";
+const REQUIRED_INSTALL_FILES = [
+  ["commands", "mednotes", "status.md"],
+  ["agents", "med-knowledge-architect.md"],
+  ["mednotes", "AGENTS.md"],
+  ["plugins", "mednotes-fsm.mjs"],
+];
+
+function findPackagedOpenCodeDir() {
+  const candidates = [
+    path.join(PACKAGE_ROOT, ".opencode"),
+    path.join(PACKAGE_ROOT, "manifests", "opencode-plugin", ".opencode"),
+  ];
+  for (const candidate of candidates) {
+    if (existsSync(path.join(candidate, "opencode.json"))) {
+      return candidate;
+    }
+  }
+  return candidates[0];
+}
 
 function usage() {
   return [
@@ -19,6 +43,9 @@ function configPathFromEnv() {
   if (process.env.OPENCODE_CONFIG) {
     return process.env.OPENCODE_CONFIG;
   }
+  if (process.env.OPENCODE_CONFIG_DIR) {
+    return path.join(process.env.OPENCODE_CONFIG_DIR, "opencode.json");
+  }
   if (process.platform === "win32") {
     const appData = process.env.APPDATA ?? path.join(os.homedir(), "AppData", "Roaming");
     return path.join(appData, "opencode", "opencode.json");
@@ -88,18 +115,106 @@ function normalizePlugins(value, pluginSpec) {
   return [...preserved, pluginSpec];
 }
 
+function normalizeInstructions(value, instructionPath) {
+  const existing = Array.isArray(value) ? value : [];
+  const preserved = existing.filter((entry) => {
+    if (typeof entry !== "string") {
+      return true;
+    }
+    return !entry.includes("mednotes/AGENTS.md") && !entry.includes("mednotes\\AGENTS.md");
+  });
+  return [...preserved, instructionPath];
+}
+
+function objectValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+
+async function readGeneratedConfig() {
+  return JSON.parse(await readFile(GENERATED_CONFIG, "utf8"));
+}
+
+function localPluginSpec(configDir) {
+  return pathToFileURL(path.join(configDir, "plugins", "mednotes-fsm.mjs")).href;
+}
+
+function requiredInstallFilesPresent(configDir) {
+  return REQUIRED_INSTALL_FILES.every((parts) => existsSync(path.join(configDir, ...parts)));
+}
+
+async function copyOpenCodeSurface(configDir, dryRun) {
+  const installs = [
+    ["commands", "commands"],
+    ["agents", "agents"],
+    ["mednotes", "mednotes"],
+    ["plugins", "plugins"],
+    ["mednotes.generated.json", "mednotes.generated.json"],
+  ];
+  if (dryRun) {
+    return installs.map(([, target]) => path.join(configDir, target));
+  }
+  for (const [source, target] of installs) {
+    const sourcePath = path.join(PACKAGE_OPENCODE, source);
+    const targetPath = path.join(configDir, target);
+    await mkdir(path.dirname(targetPath), { recursive: true });
+    await cp(sourcePath, targetPath, { recursive: true, force: true });
+  }
+  await rewriteRuntimeReferences(path.join(configDir, "commands"), path.join(configDir, "mednotes"));
+  await rewriteRuntimeReferences(path.join(configDir, "agents"), path.join(configDir, "mednotes"));
+  return installs.map(([, target]) => path.join(configDir, target));
+}
+
+async function rewriteRuntimeReferences(root, runtimeRoot) {
+  if (!existsSync(root)) {
+    return;
+  }
+  const entries = await readdir(root, { withFileTypes: true });
+  for (const entry of entries) {
+    const entryPath = path.join(root, entry.name);
+    if (entry.isDirectory()) {
+      await rewriteRuntimeReferences(entryPath, runtimeRoot);
+      continue;
+    }
+    if (!entry.isFile() || !entry.name.endsWith(".md")) {
+      continue;
+    }
+    const current = await readFile(entryPath, "utf8");
+    const next = current.replaceAll(MEDNOTES_RUNTIME_REF, runtimeRoot);
+    if (next !== current) {
+      await writeFile(entryPath, next, "utf8");
+    }
+  }
+}
+
+function mergeAgentConfig(config, generatedConfig) {
+  const currentAgent = objectValue(config.agent);
+  const generatedAgent = objectValue(generatedConfig.agent);
+  const nextAgent = { ...currentAgent };
+  for (const [agentId, runtimeConfig] of Object.entries(generatedAgent)) {
+    nextAgent[agentId] = { ...objectValue(currentAgent[agentId]), ...objectValue(runtimeConfig) };
+  }
+  return nextAgent;
+}
+
 async function install(options) {
   const configPath = path.resolve(options.configPath);
+  const configDir = path.dirname(configPath);
+  const generatedConfig = await readGeneratedConfig();
+  const pluginSpec = options.pluginSpec === PACKAGE_SPEC ? localPluginSpec(configDir) : options.pluginSpec;
+  const assetsWereMissing = !requiredInstallFilesPresent(configDir);
   const config = await readConfig(configPath);
   const before = `${JSON.stringify(config, null, 2)}\n`;
   config.$schema = typeof config.$schema === "string" ? config.$schema : OPENCODE_SCHEMA;
-  config.plugin = normalizePlugins(config.plugin, options.pluginSpec);
+  config.plugin = normalizePlugins(config.plugin, pluginSpec);
+  config.instructions = normalizeInstructions(config.instructions, path.join(configDir, "mednotes", "AGENTS.md"));
+  config.agent = mergeAgentConfig(config, generatedConfig);
   const after = `${JSON.stringify(config, null, 2)}\n`;
-  const changed = before !== after;
+  const changed = before !== after || assetsWereMissing;
   const backupPath = `${configPath}.bak.${new Date().toISOString().replace(/[:.]/g, "-")}`;
+  const installedPaths = await copyOpenCodeSurface(configDir, options.dryRun);
 
   if (changed && !options.dryRun) {
-    await mkdir(path.dirname(configPath), { recursive: true });
+    await mkdir(configDir, { recursive: true });
     if (existsSync(configPath)) {
       await copyFile(configPath, backupPath);
     }
@@ -109,22 +224,27 @@ async function install(options) {
   return {
     status: changed ? "updated" : "already_configured",
     config_path: configPath,
-    plugin: options.pluginSpec,
+    plugin: pluginSpec,
     dry_run: options.dryRun,
+    installed_paths: installedPaths,
     backup_path: changed && !options.dryRun && existsSync(backupPath) ? backupPath : null,
   };
 }
 
 async function doctor(options) {
   const configPath = path.resolve(options.configPath);
+  const configDir = path.dirname(configPath);
   const config = await readConfig(configPath);
   const plugin = Array.isArray(config.plugin) ? config.plugin : [];
+  const pluginConfigured = plugin.some(
+    (entry) => typeof entry === "string" && (entry.includes("mednotes-opencode") || entry.includes("mednotes-fsm.mjs")),
+  );
+  const surfaceConfigured = requiredInstallFilesPresent(configDir);
   return {
-    status: plugin.some((entry) => typeof entry === "string" && entry.includes("mednotes-opencode"))
-      ? "configured"
-      : "missing",
+    status: pluginConfigured && surfaceConfigured ? "configured" : pluginConfigured ? "incomplete" : "missing",
     config_path: configPath,
     plugin,
+    surface_configured: surfaceConfigured,
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mednotes-opencode",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MedNotes plugin for OpenCode: FSM-first medical notes workflows for Obsidian and Anki.",
   "type": "module",
   "private": false,