wendkeep 0.69.0 → 0.70.0

package/src/observer.mjs

@@ -0,0 +1,108 @@
+import { homedir } from 'node:os';
+import { isAbsolute, resolve } from 'node:path';
+import { appendObserverEvent, readObserverIndex, registerObserverProject } from './observer-store.mjs';
+import { buildProjectSnapshot } from './observer-snapshot.mjs';
+import { startObserverServer } from './observer-server.mjs';
+import { resolveProjectVault } from '../packages/vault/src/project-vault.mjs';
+
+export const OBSERVER_HELP = `wendkeep observer — Observer local multi-projeto
+
+Uso:
+  wendkeep observer serve [--data-dir P] [--host 127.0.0.1] [--port 8787] [--token T]
+                          [--allow-non-loopback]
+  wendkeep observer register --project P [--vault V] [--data-dir D] [--json]
+  wendkeep observer publish --project P [--vault V] [--data-dir D] [--json]
+  wendkeep observer status [--data-dir D] [--json]
+
+O vault continua local e é a fonte oficial. O Observer armazena apenas snapshots sanitizados
+e um índice reconstruível; o container não monta nem copia vaults de projetos.
+`;
+
+function optionValue(argv, name) {
+  const index = argv.indexOf(name);
+  if (index >= 0) return argv[index + 1] || '';
+  return argv.find((item) => item.startsWith(`${name}=`))?.slice(name.length + 1) || '';
+}
+
+function dataDir(argv) {
+  return resolve(optionValue(argv, '--data-dir')
+    || process.env.WENDKEEP_OBSERVER_DATA_DIR
+    || `${homedir()}/.wendkeep-observer`);
+}
+
+function projectRoot(argv) {
+  const value = optionValue(argv, '--project') || process.cwd();
+  return isAbsolute(value) ? resolve(value) : resolve(process.cwd(), value);
+}
+
+function vaultBase(argv, root) {
+  const explicit = optionValue(argv, '--vault');
+  if (explicit) return isAbsolute(explicit) ? resolve(explicit) : resolve(root, explicit);
+  return resolveProjectVault({ startDir: root }).base;
+}
+
+function print(value, asJson) {
+  process.stdout.write(`${asJson ? JSON.stringify(value, null, 2) : String(value)}\n`);
+}
+
+function summary(index) {
+  return {
+    schema_version: index.schema_version,
+    projects: index.projects.map(({ snapshot, ...item }) => item),
+  };
+}
+
+export async function runObserver(argv = []) {
+  const [sub] = argv;
+  const asJson = argv.includes('--json');
+  if (!sub || sub === 'help') {
+    process.stdout.write(OBSERVER_HELP);
+    return 0;
+  }
+  const dir = dataDir(argv);
+
+  if (sub === 'status') {
+    print(summary(readObserverIndex(dir)), asJson);
+    return 0;
+  }
+
+  if (sub === 'serve') {
+    const token = optionValue(argv, '--token') || process.env.WENDKEEP_OBSERVER_TOKEN || '';
+    const host = optionValue(argv, '--host') || '127.0.0.1';
+    const server = await startObserverServer({
+      dataDir: dir,
+      host,
+      port: Number(optionValue(argv, '--port') || 8787),
+      token,
+      allowNonLoopback: argv.includes('--allow-non-loopback'),
+    });
+    if (!token) {
+      await server.close();
+      throw new Error('Observer exige --token ou WENDKEEP_OBSERVER_TOKEN.');
+    }
+    const address = server.address();
+    process.stdout.write(`wendkeep observer listening: http://${address.address}:${address.port}\n`);
+    return 0;
+  }
+
+  if (!['register', 'publish'].includes(sub)) throw new Error(`observer: subcomando desconhecido: ${sub}`);
+  const root = projectRoot(argv);
+  const vault = vaultBase(argv, root);
+  const snapshot = buildProjectSnapshot({ vaultBase: vault, projectRoot: root });
+
+  if (sub === 'register') {
+    const result = registerObserverProject(dir, {
+      projectId: snapshot.project_id,
+      projectName: snapshot.project_name,
+      wendkeepVersion: snapshot.wendkeep_version,
+    });
+    if (!result.registered) throw new Error(result.errors.join(' '));
+    print(result, asJson);
+    return 0;
+  }
+
+  const result = appendObserverEvent(dir, snapshot);
+  if (!result.accepted && !result.duplicate) throw new Error(result.errors.join(' '));
+  print({ ok: true, ...result }, asJson);
+  return 0;
+}

package/src/taxonomy.mjs

@@ -99,6 +99,7 @@ export const HOOK_FILES = [
   'change-guard.mjs',
   'change-nag.mjs',
   'plan-capture.mjs',
+  'observer-publish.mjs',
 ];
 
 // Hook scripts that are safe to invoke directly via `wendkeep hook <name>`.
@@ -122,6 +123,7 @@ export const RUNNABLE_HOOKS = [
   'change-guard',
   'change-nag',
   'plan-capture',
+  'observer-publish',
 ];
 
 // --- companion plugins / MCP --------------------------------------------------