@pellux/goodvibes-tui 0.18.4

package/bin/goodvibes

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { accessSync, constants } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = join(__dirname, '..');
+
+if (process.platform === 'win32') {
+  console.error('goodvibes: native Windows is not supported.');
+  console.error('Use WSL so the Linux release binary path applies.');
+  process.exit(1);
+}
+
+function resolveArtifactName(platform, arch) {
+  if (platform === 'linux' && arch === 'x64') return 'goodvibes-linux-x64';
+  if (platform === 'linux' && arch === 'arm64') return 'goodvibes-linux-arm64';
+  if (platform === 'darwin' && arch === 'x64') return 'goodvibes-macos-x64';
+  if (platform === 'darwin' && arch === 'arm64') return 'goodvibes-macos-arm64';
+  return null;
+}
+
+function isExecutable(path) {
+  try {
+    accessSync(path, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function run(command, args) {
+  const child = spawnSync(command, args, { stdio: 'inherit' });
+  if (child.error) {
+    throw child.error;
+  }
+  process.exit(child.status ?? 1);
+}
+
+const artifactName = resolveArtifactName(process.platform, process.arch);
+const vendoredBinary = artifactName ? join(packageRoot, 'vendor', artifactName) : null;
+
+if (vendoredBinary && isExecutable(vendoredBinary)) {
+  run(vendoredBinary, process.argv.slice(2));
+}
+
+const bunProbe = spawnSync('bun', ['--version'], { stdio: 'ignore' });
+if (bunProbe.status === 0) {
+  run('bun', [join(packageRoot, 'src', 'main.ts'), ...process.argv.slice(2)]);
+}
+
+const supported = [
+  'linux-x64',
+  'linux-arm64',
+  'darwin-x64',
+  'darwin-arm64',
+].join(', ');
+
+console.error('goodvibes: no runnable binary is available.');
+console.error(`platform: ${process.platform}-${process.arch}`);
+console.error(`supported prebuilt targets: ${supported}`);
+console.error('Either:');
+console.error('  1. install Bun and re-run the command, or');
+console.error('  2. reinstall after a matching GitHub release asset exists for this version.');
+process.exit(1);

package/docs/README.md

@@ -0,0 +1,32 @@
+# Documentation
+
+This directory contains the current product documentation for `goodvibes-tui`.
+
+## Guides
+
+- [Getting started](getting-started.md)
+  Installation, first-run setup, provider configuration, common paths, and basic run/build flows.
+
+- [Deployment and services](deployment-and-services.md)
+  TUI-only mode, compiled binary behavior, in-process daemon/listener hosting, source-run daemon mode, inbound TLS, outbound trust configuration, and control-plane entrypoints.
+
+- [Providers and routing](providers-and-routing.md)
+  Native providers, compatible/gateway providers, local discovery, synthetic failover, search providers, voice providers, and media providers.
+
+- [Knowledge, artifacts, and multimodal](knowledge-artifacts-and-multimodal.md)
+  Session memory, durable memory, structured knowledge, connectors, extractors, embeddings, artifacts, and multimodal analysis.
+
+- [Channels, remote runtime, and API](channels-remote-and-api.md)
+  Omnichannel surfaces, reply routing, remote peers, node-host contracts, and the daemon/control-plane HTTP + streaming surfaces.
+
+- [Tools and commands](tools-and-commands.md)
+  Built-in tool families, slash-command families, and the operator/workflow surfaces that tie them together.
+
+- [Release and publishing](release-and-publishing.md)
+  Release validation, GitHub CD, compiled binary releases, and optional Bun-oriented npm distribution.
+
+- [Release notes](releases/0.18.4.md)
+  Version-specific release notes for shipped TUI releases.
+
+- [Foundation artifacts](foundation-artifacts/README.md)
+  Checked-in operator and peer contract manifests plus canonical knowledge GraphQL and SQL artifacts for release-gate and SDK extraction work.

package/docs/foundation-artifacts/README.md

@@ -0,0 +1,16 @@
+## Foundation Artifacts
+
+These files are the checked-in canonical artifacts for the current GoodVibes foundation surfaces.
+
+- `operator-contract.json` — typed operator/client contract manifest
+- `peer-contract.json` — node-host / peer contract manifest
+- `knowledge-graphql.graphql` — canonical knowledge GraphQL schema text
+- `knowledge-store.sql` — canonical knowledge SQL schema
+
+Regenerate them with:
+
+```bash
+bun run foundation:artifacts
+```
+
+The release-gate tests fail if these artifacts drift from the current source.

package/docs/foundation-artifacts/knowledge-graphql.graphql

@@ -0,0 +1,397 @@
+scalar JSON
+
+enum KnowledgeProjectionKind {
+  OVERVIEW
+  BUNDLE
+  SOURCE
+  NODE
+  ISSUE
+  DASHBOARD
+  ROLLUP
+}
+
+enum KnowledgePacketDetail {
+  COMPACT
+  STANDARD
+  DETAILED
+}
+
+enum KnowledgeJobMode {
+  INLINE
+  BACKGROUND
+}
+
+type KnowledgeStatus {
+  ready: Boolean!
+  storagePath: String!
+  sourceCount: Int!
+  nodeCount: Int!
+  edgeCount: Int!
+  issueCount: Int!
+  extractionCount: Int!
+  jobRunCount: Int!
+  usageCount: Int!
+  candidateCount: Int!
+  reportCount: Int!
+  scheduleCount: Int!
+  note: String!
+}
+
+type KnowledgeConnectorSetupField {
+  key: String!
+  label: String!
+  kind: String!
+  optional: Boolean
+  source: String
+  description: String
+}
+
+type KnowledgeConnectorSetup {
+  version: String!
+  summary: String!
+  transportHints: [String!]!
+  steps: [String!]!
+  fields: [KnowledgeConnectorSetupField!]!
+  metadata: JSON
+}
+
+type KnowledgeConnectorDoctorCheck {
+  id: String!
+  label: String!
+  status: String!
+  detail: String!
+  metadata: JSON
+}
+
+type KnowledgeConnectorDoctorReport {
+  connectorId: String!
+  ready: Boolean!
+  summary: String!
+  checks: [KnowledgeConnectorDoctorCheck!]!
+  hints: [String!]!
+  metadata: JSON
+}
+
+type KnowledgeConnector {
+  id: String!
+  displayName: String
+  version: String
+  description: String!
+  sourceType: String!
+  inputSchema: JSON
+  examples: [JSON!]!
+  capabilities: [String!]!
+  setup: KnowledgeConnectorSetup
+  metadata: JSON
+}
+
+type KnowledgeSource {
+  id: String!
+  connectorId: String!
+  sourceType: String!
+  title: String
+  sourceUri: String
+  canonicalUri: String
+  summary: String
+  description: String
+  tags: [String!]!
+  folderPath: String
+  status: String!
+  artifactId: String
+  contentHash: String
+  lastCrawledAt: Float
+  crawlError: String
+  sessionId: String
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeNode {
+  id: String!
+  kind: String!
+  slug: String!
+  title: String!
+  summary: String
+  aliases: [String!]!
+  status: String!
+  confidence: Int!
+  sourceId: String
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeEdge {
+  id: String!
+  fromKind: String!
+  fromId: String!
+  toKind: String!
+  toId: String!
+  relation: String!
+  weight: Float!
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeIssue {
+  id: String!
+  severity: String!
+  code: String!
+  message: String!
+  status: String!
+  sourceId: String
+  nodeId: String
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeExtraction {
+  id: String!
+  sourceId: String!
+  artifactId: String
+  extractorId: String!
+  format: String!
+  title: String
+  summary: String
+  excerpt: String
+  sections: [String!]!
+  links: [String!]!
+  estimatedTokens: Int!
+  structure: JSON
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeItemView {
+  source: KnowledgeSource
+  node: KnowledgeNode
+  issue: KnowledgeIssue
+  relatedEdges: [KnowledgeEdge!]!
+  linkedSources: [KnowledgeSource!]!
+  linkedNodes: [KnowledgeNode!]!
+}
+
+type KnowledgeSearchResult {
+  kind: String!
+  id: String!
+  score: Float!
+  reason: String!
+  source: KnowledgeSource
+  node: KnowledgeNode
+}
+
+type KnowledgePacketItem {
+  kind: String!
+  id: String!
+  title: String!
+  summary: String
+  uri: String
+  reason: String!
+  score: Float!
+  estimatedTokens: Int!
+  related: [String!]!
+  evidence: [String!]!
+  metadata: JSON
+}
+
+type KnowledgePacket {
+  task: String!
+  writeScope: [String!]!
+  generatedAt: Float!
+  detail: KnowledgePacketDetail!
+  strategy: String!
+  budgetLimit: Int!
+  estimatedTokens: Int!
+  items: [KnowledgePacketItem!]!
+}
+
+type KnowledgeProjectionTarget {
+  targetId: String!
+  kind: KnowledgeProjectionKind!
+  title: String!
+  description: String!
+  itemId: String
+  defaultPath: String!
+  defaultFilename: String!
+  metadata: JSON
+}
+
+type KnowledgeProjectionPage {
+  path: String!
+  title: String!
+  format: String!
+  content: String!
+  itemIds: [String!]!
+  metadata: JSON
+}
+
+type KnowledgeProjectionBundle {
+  id: String!
+  target: KnowledgeProjectionTarget!
+  generatedAt: Float!
+  pageCount: Int!
+  pages: [KnowledgeProjectionPage!]!
+  metadata: JSON
+}
+
+type ArtifactDescriptor {
+  id: String!
+  kind: String!
+  mimeType: String!
+  filename: String
+  sizeBytes: Int!
+  sourceUri: String
+  createdAt: Float!
+  metadata: JSON
+}
+
+type KnowledgeJob {
+  id: String!
+  label: String!
+  description: String!
+  defaultMode: KnowledgeJobMode!
+  triggerKinds: [String!]!
+  lastRunAt: Float
+  metadata: JSON
+}
+
+type KnowledgeJobRun {
+  id: String!
+  jobId: String!
+  status: String!
+  mode: KnowledgeJobMode!
+  requestedAt: Float!
+  startedAt: Float
+  completedAt: Float
+  error: String
+  result: JSON
+  metadata: JSON
+}
+
+type KnowledgeBatchIngestResult {
+  imported: Int!
+  failed: Int!
+  sources: [KnowledgeSource!]!
+  errors: [String!]!
+}
+
+type KnowledgeUsageRecord {
+  id: String!
+  targetKind: String!
+  targetId: String!
+  usageKind: String!
+  task: String
+  sessionId: String
+  score: Float
+  metadata: JSON
+  createdAt: Float!
+}
+
+type KnowledgeConsolidationCandidate {
+  id: String!
+  candidateType: String!
+  status: String!
+  subjectKind: String!
+  subjectId: String!
+  title: String!
+  summary: String
+  score: Float!
+  evidence: [String!]!
+  suggestedMemoryClass: String
+  suggestedScope: String
+  decidedAt: Float
+  decidedBy: String
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeConsolidationReport {
+  id: String!
+  kind: String!
+  title: String!
+  summary: String!
+  highlights: [String!]!
+  metrics: JSON
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+type KnowledgeSchedule {
+  id: String!
+  jobId: String!
+  label: String!
+  enabled: Boolean!
+  schedule: JSON!
+  lastRunAt: Float
+  nextRunAt: Float
+  metadata: JSON
+  createdAt: Float!
+  updatedAt: Float!
+}
+
+input KnowledgeJobRunInput {
+  mode: KnowledgeJobMode
+}
+
+input KnowledgePacketInput {
+  task: String!
+  writeScope: [String!]
+  limit: Int
+  detail: KnowledgePacketDetail
+  budgetLimit: Int
+}
+
+type Query {
+  status: KnowledgeStatus!
+  connectors: [KnowledgeConnector!]!
+  connectorDoctor(id: String!): KnowledgeConnectorDoctorReport
+  sources(limit: Int, offset: Int): [KnowledgeSource!]!
+  nodes(limit: Int, offset: Int): [KnowledgeNode!]!
+  issues(limit: Int, offset: Int): [KnowledgeIssue!]!
+  itemView(kind: String!, id: String!): KnowledgeItemView
+  extractions(limit: Int, sourceId: String): [KnowledgeExtraction!]!
+  neighbors(kind: String!, id: String!, relation: String, limit: Int): [KnowledgeEdge!]!
+  search(query: String!, limit: Int): [KnowledgeSearchResult!]!
+  packet(task: String!, writeScope: [String!], limit: Int, detail: KnowledgePacketDetail, budgetLimit: Int): KnowledgePacket!
+  projectionTargets(limit: Int): [KnowledgeProjectionTarget!]!
+  projection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeProjectionBundle!
+  jobs: [KnowledgeJob!]!
+  job(id: String!): KnowledgeJob
+  jobRuns(limit: Int, jobId: String): [KnowledgeJobRun!]!
+  usage(limit: Int, targetKind: String, targetId: String, usageKind: String): [KnowledgeUsageRecord!]!
+  usageRecords(limit: Int, targetKind: String, targetId: String, usageKind: String): [KnowledgeUsageRecord!]!
+  consolidationCandidates(limit: Int, status: String): [KnowledgeConsolidationCandidate!]!
+  consolidationReports(limit: Int): [KnowledgeConsolidationReport!]!
+  schedules(limit: Int): [KnowledgeSchedule!]!
+  sourceExtraction(sourceId: String!): KnowledgeExtraction
+}
+
+type Mutation {
+  ingestUrl(url: String!, sourceType: String, connectorId: String, folderPath: String, tags: [String!], sessionId: String, allowPrivateHosts: Boolean): KnowledgeSource!
+  ingestArtifact(path: String!, connectorId: String, tags: [String!], sessionId: String, allowPrivateHosts: Boolean): KnowledgeSource!
+  importBookmarksFromFile(path: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!
+  importUrlsFromFile(path: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!
+  ingestBookmarkSeeds(seeds: [String!]!, connectorId: String, sessionId: String): KnowledgeBatchIngestResult!
+  ingestWithConnector(connectorId: String!, input: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!
+  ingestConnectorInput(input: String!, connectorId: String, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!
+  renderProjection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeProjectionBundle!
+  materializeProjection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeMaterializedProjection!
+  reindex: KnowledgeStatus!
+  runJob(id: String!, mode: KnowledgeJobMode): KnowledgeJobRun!
+  saveSchedule(id: String, jobId: String!, label: String!, enabled: Boolean!, schedule: JSON!, metadata: JSON): KnowledgeSchedule!
+  deleteSchedule(id: String!): Boolean!
+  setScheduleEnabled(id: String!, enabled: Boolean!): KnowledgeSchedule
+  decideConsolidationCandidate(id: String!, status: String!, decidedBy: String): KnowledgeConsolidationCandidate!
+  lint: [KnowledgeIssue!]!
+}
+
+type KnowledgeMaterializedProjection {
+  artifact: ArtifactDescriptor!
+  bundle: KnowledgeProjectionBundle!
+}

package/docs/foundation-artifacts/knowledge-store.sql

@@ -0,0 +1,183 @@
+CREATE TABLE IF NOT EXISTS knowledge_sources (
+      id TEXT PRIMARY KEY,
+      connector_id TEXT NOT NULL,
+      source_type TEXT NOT NULL,
+      title TEXT,
+      source_uri TEXT,
+      canonical_uri TEXT,
+      summary TEXT,
+      description TEXT,
+      tags TEXT NOT NULL DEFAULT '[]',
+      folder_path TEXT,
+      status TEXT NOT NULL,
+      artifact_id TEXT,
+      content_hash TEXT,
+      last_crawled_at INTEGER,
+      crawl_error TEXT,
+      session_id TEXT,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_sources_canonical_uri ON knowledge_sources(canonical_uri);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_sources_updated_at ON knowledge_sources(updated_at);
+
+CREATE TABLE IF NOT EXISTS knowledge_nodes (
+      id TEXT PRIMARY KEY,
+      kind TEXT NOT NULL,
+      slug TEXT NOT NULL,
+      title TEXT NOT NULL,
+      summary TEXT,
+      aliases TEXT NOT NULL DEFAULT '[]',
+      status TEXT NOT NULL,
+      confidence INTEGER NOT NULL,
+      source_id TEXT,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_knowledge_nodes_kind_slug ON knowledge_nodes(kind, slug);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_nodes_updated_at ON knowledge_nodes(updated_at);
+
+CREATE TABLE IF NOT EXISTS knowledge_edges (
+      id TEXT PRIMARY KEY,
+      from_kind TEXT NOT NULL,
+      from_id TEXT NOT NULL,
+      to_kind TEXT NOT NULL,
+      to_id TEXT NOT NULL,
+      relation TEXT NOT NULL,
+      weight REAL NOT NULL,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_knowledge_edges_unique ON knowledge_edges(from_kind, from_id, to_kind, to_id, relation);
+
+CREATE TABLE IF NOT EXISTS knowledge_issues (
+      id TEXT PRIMARY KEY,
+      severity TEXT NOT NULL,
+      code TEXT NOT NULL,
+      message TEXT NOT NULL,
+      status TEXT NOT NULL,
+      source_id TEXT,
+      node_id TEXT,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_issues_code ON knowledge_issues(code);
+
+CREATE TABLE IF NOT EXISTS knowledge_extractions (
+      id TEXT PRIMARY KEY,
+      source_id TEXT NOT NULL,
+      artifact_id TEXT,
+      extractor_id TEXT NOT NULL,
+      format TEXT NOT NULL,
+      title TEXT,
+      summary TEXT,
+      excerpt TEXT,
+      sections TEXT NOT NULL DEFAULT '[]',
+      links TEXT NOT NULL DEFAULT '[]',
+      estimated_tokens INTEGER NOT NULL DEFAULT 0,
+      structure TEXT NOT NULL DEFAULT '{}',
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_knowledge_extractions_source_id ON knowledge_extractions(source_id);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_extractions_format ON knowledge_extractions(format);
+
+CREATE TABLE IF NOT EXISTS knowledge_job_runs (
+      id TEXT PRIMARY KEY,
+      job_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      mode TEXT NOT NULL,
+      requested_at INTEGER NOT NULL,
+      started_at INTEGER,
+      completed_at INTEGER,
+      error TEXT,
+      result TEXT NOT NULL DEFAULT '{}',
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_job_runs_job_id ON knowledge_job_runs(job_id);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_job_runs_requested_at ON knowledge_job_runs(requested_at);
+
+CREATE TABLE IF NOT EXISTS knowledge_usage_records (
+      id TEXT PRIMARY KEY,
+      target_kind TEXT NOT NULL,
+      target_id TEXT NOT NULL,
+      usage_kind TEXT NOT NULL,
+      task TEXT,
+      session_id TEXT,
+      score REAL,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_usage_target ON knowledge_usage_records(target_kind, target_id);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_usage_created_at ON knowledge_usage_records(created_at);
+
+CREATE TABLE IF NOT EXISTS knowledge_consolidation_candidates (
+      id TEXT PRIMARY KEY,
+      candidate_type TEXT NOT NULL,
+      status TEXT NOT NULL,
+      subject_kind TEXT NOT NULL,
+      subject_id TEXT NOT NULL,
+      title TEXT NOT NULL,
+      summary TEXT,
+      score REAL NOT NULL,
+      evidence TEXT NOT NULL DEFAULT '[]',
+      suggested_memory_class TEXT,
+      suggested_scope TEXT,
+      decided_at INTEGER,
+      decided_by TEXT,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_candidates_subject ON knowledge_consolidation_candidates(subject_kind, subject_id);
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_candidates_status ON knowledge_consolidation_candidates(status);
+
+CREATE TABLE IF NOT EXISTS knowledge_consolidation_reports (
+      id TEXT PRIMARY KEY,
+      kind TEXT NOT NULL,
+      title TEXT NOT NULL,
+      summary TEXT NOT NULL,
+      highlights TEXT NOT NULL DEFAULT '[]',
+      metrics TEXT NOT NULL DEFAULT '{}',
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_reports_kind ON knowledge_consolidation_reports(kind);
+
+CREATE TABLE IF NOT EXISTS knowledge_schedules (
+      id TEXT PRIMARY KEY,
+      job_id TEXT NOT NULL,
+      label TEXT NOT NULL,
+      enabled INTEGER NOT NULL,
+      schedule TEXT NOT NULL,
+      last_run_at INTEGER,
+      next_run_at INTEGER,
+      metadata TEXT NOT NULL DEFAULT '{}',
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+
+CREATE INDEX IF NOT EXISTS idx_knowledge_schedules_job_id ON knowledge_schedules(job_id);