// Command libraryagent is the host-side execution boundary for whole-library // capture. It runs as the ordinary operator account, owns no network listener // other than one 0600 unix socket, and executes exactly one fixed command shape. package main import ( "context" "flag" "log" "os" "os/signal" "path/filepath" "syscall" "time" "knowledge-governance/internal/libraryagent" "knowledge-governance/internal/librarymaintenance" ) func main() { home, _ := os.UserHomeDir() var config libraryagent.Config flag.StringVar(&config.Socket, "socket", filepath.Join(home, ".local/share/knowledge-governance/agent.sock"), "unix socket for capture requests") flag.StringVar(&config.Binary, "binary", "/home/zheromiku/knowledge-governance/libraryctl", "libraryctl binary this agent executes") flag.StringVar(&config.ArchiveRoot, "archive", filepath.Join(home, ".local/share/knowledge-governance/library"), "sealed artifact root") flag.StringVar(&config.JournalRoot, "journal", filepath.Join(home, ".local/share/knowledge-governance/freeze"), "freeze journal root") flag.StringVar(&config.SourceApp, "source-app", "WKNFull-app", "source container describing the stack") flag.StringVar(&config.SourcePG, "source-pg", "WKNFull-postgres", "source PostgreSQL container") flag.StringVar(&config.SourceES, "source-es", "WKNFull-elasticsearch", "source Elasticsearch container") flag.StringVar(&config.SourceS3Endpoint, "source-s3-endpoint", "", "host-reachable source object-store endpoint (overrides the container-internal one)") flag.StringVar(&config.GovernancePG, "governance-pg", "knowledge-governance-p1-postgres-1", "governance PostgreSQL container") flag.StringVar(&config.Project, "project", "weknora071full", "Compose project owning the writers") flag.StringVar(&config.Writers, "writers", "app", "declared writer services") nonWriters := flag.String("non-writers", defaultNonWriters, "service=reason for every other project service") flag.DurationVar(&config.MaxDuration, "max-duration", 10*time.Minute, "upper bound for one operation") describe := flag.Bool("describe", false, "print the fixed configuration and exit") flag.Parse() config.NonWriters = *nonWriters agent, err := libraryagent.New(config) if err != nil { log.Fatal(err) } // 实例级维护接线(入口闸门 + 后台队列)不在 agent 的 Config 里:它由同一份 // 环境声明提供给子进程。启动时先说清楚有没有——缺了封存会在开窗口前被拒, // 不允许"以为接好了"跑到一半才发现没有排空证据。 if target, targetErr := librarymaintenance.TargetFromEnv(os.Getenv); targetErr != nil { log.Printf("library agent: 封存会拒绝(实例级维护未接线):%v", targetErr) } else { log.Printf("library agent: 实例级维护目标 %s 入口 %s 闸门 %s", target.Instance, target.IngressURL, target.IngressService) } if *describe { log.Printf("library agent config: %+v", agent.Describe()) return } ctx, stop := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM) defer stop() log.Printf("library agent listening on %s (project %s, writers %s)", config.Socket, config.Project, config.Writers) if err = agent.Serve(ctx); err != nil { log.Fatal(err) } } // defaultNonWriters mirrors scripts/library-capture.sh: every sibling service of // the source project is declared, with the reason it cannot write knowledge. const defaultNonWriters = "frontend=UI only; no knowledge writes" + ",mcp=read-only MCP server" + ",dobotai-target=alpine placeholder; no knowledge writes" + ",docreader=parse RPC service; app persists parse output and settlement requires zero pending ops" + ",elasticsearch=search store; not an initiator" + ",postgres=database store; not an initiator" + ",redis=queue/cache store; not an initiator" + ",neo4j=graph store; not an initiator" + ",langfuse-web=LLM observability UI" + ",langfuse-worker=LLM observability worker; own storage" + ",langfuse-clickhouse=observability store" + ",langfuse-minio=observability object store" + ",langfuse-db-init=one-shot init; exited" + ",searxng=read-only search proxy" + ",searxng-init=one-shot init; exited"