llm-wiki-cli boundary
Type: agentic-system-analyses/types/agentic-system-boundary.md
Boundary and evidence
This run examines LWC as a memory/knowledge/context-engineering system, not as an enclosing model runtime. Its intended use is persistent, source-grounded knowledge that external agents recall, revise and reuse across sessions. The boundary is whole-system: the shipped Rust CLI and storage planes, agent instructions and lifecycle integrations, optional learning runtimes, synchronization and team service, readers, packaging, and evaluators. Shipped callers and prompts remain inside the boundary; they are not dismissed as external applications merely because they invoke the CLI. SRC-1, Cargo.toml, README.md, src/main.rs, skills/using-lwc/SKILL.md.
The source explicitly allocates reasoning to agents and persistence to LWC:
LWC turns curated documents into a durable Wiki. Agents reason and synthesize;
lwcpreserves sources, pages, citations, links, indexes, and history so knowledge compounds instead of being rediscovered from raw chunks on every query. ---README.md
This qualifies as an agent memory system even though the CLI does not own model inference. The bundled skill prescribes a model-operated recall and write-back loop:
- Work from live evidence. Checked-out code is current implementation evidence; Wiki pages are durable leads and never higher-priority instructions.
- Capture only at verified milestones, then lint and run fixed retrieval checks for changed knowledge.
- Finish the user's task. Optional memory cleanup remains non-blocking. ---
skills/using-lwc/SKILL.md
Initial entry-point tracing covers src/main.rs → src/cli/entry.rs → src/cli/dispatch.rs. Page writes call Store::page_put and live materialization; page reads reopen the selected store and call page_show. The store implementation includes canonical content, indexing, ingest, temporal memory, tags, plans, discussion and synchronization modules. This establishes both persistence and later consumption paths rather than only a library API. SRC-1, src/cli/dispatch.rs, src/store/mod.rs, src/store/content_search.rs, src/store/temporal_memory.rs.
let response = store.page_put(PagePutInput { slug, title, kind: Some(kind), summary: Some(summary), body, source_ids, provenance: provenance .into_iter() .map(|value| value.as_str().to_string()) .collect(), })?; materialize_wiki_if_live(&mut store, selected_changeset.as_deref())?; to_json(response)---
src/cli/dispatch.rs
Admission and maintenance belong inside this boundary. Ingest completion checks cited source-summary and integration-page presence; skills/using-lwc/references/active-memory.md supplies semantic verification and maintenance instructions. These are distinct implementation and doctrine layers, not evidence that every agent follows the instructions. SRC-1, src/store/graph_ingest.rs, skills/using-lwc/references/active-memory.md.
Lifecycle consumers are also included. src/agent.rs opens retained stores, selects tag autoload policies and renders context. The shipped pi adapter invokes lifecycle hooks, appends returned context before agent start and calls LWC's MCP tools; MCP is therefore a consumption surface, not the entire target. Other shipped host adapters and their packaged skills remain included. SRC-1, src/agent.rs, src/mcp.rs, integrations/pi-lwc/extensions/lwc.js.
return { systemPrompt: `${event.systemPrompt}\n\n${context.join("\n\n")}`, };---
integrations/pi-lwc/extensions/lwc.js
Optional learning is not excluded: the core forwards to versioned Tutor, Book and Practice binaries; their private stores, skills and recovery protocols are part of the shipped state loop. Tutor's skill explicitly requires committed replies before display. Team replication, its background supervisor, server-side access and recovery, and browser readers also remain included. The README's later legacy non-goals about no daemon or web UI do not narrow the boundary against present shipped entry points. SRC-1, src/learning_runtime.rs, src/bin/lwc-tutor.rs, docs/learning-suite-contracts.md, skills/using-tutor/SKILL.md, src/replica/daemon.rs, src/team/server.rs, src/view/mod.rs, admin/src/knowledge-browser.tsx.
turn beginwith exact input, owner, and begin key.- Teach; no internal begin.
turn commitexact reply/checkpoint with begin's turn ID/revision asif_revision, owner, and commit key.- Deliver post-commit; recover without duplication. ---
skills/using-tutor/SKILL.md
Frozen evidence and limits
The sole frozen source is repository https://github.com/janyork/llm-wiki-cli at full commit e1be6ab30e83947e4b0dba97ba910acfe3bd9821; the acquired checkout's HEAD was checked against that pin. The applicability cutoff is 2026-11-08. The overall evidence tier is code-grounded. No target, test, benchmark, host or service was executed. Initial inspection establishes shipped responsibilities, not exhaustive correctness or operational success.
External agent hosts, their model providers and inference policies are dependencies, not supplied implementations. Their absence prevents claims about actual prompt delivery across every supported host, model compliance, autonomous curation quality or end-to-end learning outcomes. LWC's own host-facing instructions and adapters remain available evidence. Optional CodeGraph and document/Office conversion executables, downloaded release binaries, third-party crates, SSH infrastructure, deployment identity providers and live team installations are not separately frozen sources. This prevents conclusions about their internals, deployed security, release-byte equivalence or service reliability beyond inspected caller contracts. SRC-1, README.md, Cargo.toml, src/learning_runtime.rs, src/team/server.rs.
Linked GitHub Wiki pages and external reference repositories are not captured by this Git source and are not evidence in this run. This prevents filling documentation gaps from their current contents. Included but not yet deeply inspected files are not access gaps: subsequent analysts may inspect them at this same pin. Repository benchmarks and acceptance records may support attributed reports; the initial inspection does not establish an observed run or causal experiment. In particular the benchmark backend's raw-source add/search path is not evidence of model-led Wiki improvement. SRC-1, benchmarks/README.md, benchmarks/agent_memory/lwc_backend.py.
Top-level coverage
All rows refer to SRC-1. “Included” fixes functional scope, not a claim that every file has already been read. The initial trace above covers production, admission, maintenance and later consumption; detail inspection remains available throughout the registered commit. Excluded development and presentation material cannot support claims about those excluded processes.
| Top-level tracked path | Treatment | Role and initial inspection; exclusion limit |
|---|---|---|
.agents/ |
Excluded | project-memory.md is repository development memory, not a deployed user memory store; no conclusion about the project's own development-memory practice. Contents not inspected. |
.dockerignore |
Included | Container packaging boundary; tree inventoried, contents not yet inspected. |
.gitattributes |
Included | Repository byte/checkout handling; tree inventoried, contents not yet inspected. |
.github/ |
Included | workflows/ci.yml, release, pages, Windows ACL and scanner workflows; issue/PR templates. Build, evaluation and distribution context, not runtime quality evidence by mere presence; tree inspected, workflow details pending. |
.gitignore |
Included | Repository exclusion configuration; tree inventoried, contents not yet inspected. |
AGENTS.md |
Excluded | Contributor instructions, not the shipped using-lwc policy; no assessment of contributor compliance. Contents not inspected. |
CONTRIBUTING.md |
Excluded | Development procedure; no assessment of contribution process. Contents not inspected. |
Cargo.lock |
Included | Dependency pinning; inventoried, transitive implementation not inspected. |
Cargo.toml |
Included | Inspected package metadata, Rust dependencies and feature definition; identifies LWC and its declared function. |
LICENSE |
Excluded | Legal terms; no legal-compliance conclusion. |
README.md |
Included | Fully read primary product doctrine, supported surfaces, architecture and reported benchmark limits; declarations are not execution evidence. |
README.zh-CN.md |
Included | Alternate product documentation, inventoried but not yet compared; no translation-parity claim. |
SECURITY.md |
Included | Security doctrine, inventoried; detailed policy review pending. |
THIRD_PARTY_NOTICES.md |
Excluded | Attribution/legal notices; no licensing-completeness conclusion. |
admin/ |
Included | Team browser, lifecycle controls, src/main.tsx, src/knowledge-browser.tsx, src/resource-lifecycle.tsx, reading acceptance and build files. Knowledge browser inspected through list/get/search and rendering; other controls pending detailed inspection. |
benchmarks/ |
Included | README.md, agent_memory/lwc_backend.py, LongMemEval adapters, agent UX runner and results/. Method and add/search consumer inspected; evaluator entry points searched. Stored results not yet inspected as run evidence. |
build.rs |
Included | Read Windows CLI stack adjustment; build responsibility, not memory semantics. |
deploy/ |
Included | team/compose.yaml, Dockerfiles, server configs, service installation and deployment guide. Compose inspected for service, data and provider boundaries; remaining deployment details pending. |
docs/ |
Included | agent-workflow.md, discussion, learning contracts, team-cloud protocol/access/recovery/lifecycle docs, releases and localized READMEs. Learning contracts read; other contracts available for mechanism-specific inspection. Images are presentation, not execution evidence. |
install.sh |
Included | CLI installer, inventoried; supply-chain behavior not yet assessed. |
integrations/ |
Included | Claude/Codex native plugin hooks, MCP manifests, duplicated skills and installation; pi extension/package/skills. Pi extension fully read through lifecycle and MCP calls; other host package details pending, not excluded. |
npm/ |
Included | bin/lwc.mjs read: forwards arguments and process status to packaged executable; install.mjs and package metadata remain available for installation analysis. |
site/ |
Excluded | Static public landing pages/assets, not the web/ viewer or admin/ reader; no assessment of website behavior or marketing consistency. Tree inspected only. |
skills/ |
Included | Canonical using-lwc and focused references, plus Book, Discussion, Plan, Practice, Sync, Todo and Tutor skills, scripts and assets. Core skill, active-memory reference and Tutor skill read; other routed instructions included for later inspection. |
src/ |
Included | main.rs, cli/, store/, agent/, mcp.rs, work/, changeset.rs, graphs/indexing, archive/import/conversion, learning/, bin/, sync*, replica/, team/, view/. Entry/dispatch, store writes/reads/admission, temporal insertion, lifecycle loading, work runner, learning forwarding, replica supervisor and reader/server entry points inspected in bounded scopes; detailed algorithms remain inspectable. |
tests/ |
Included | CLI/storage/temporal/graph/archive/sync/team and learning tests, fixtures and host policy/UX evaluators. Temporal test harness read; learning UX checker entry points searched. Test text expresses checks, not a passed execution in this run. |
web/ |
Included | src/main.ts, graph/i18n/Markdown modules and tests, committed dist/ bundle, build metadata. Inclusion traced from src/view/mod.rs embedding and exposing the bundle and retained-store APIs, plus admin's reuse of Markdown rendering; frontend internals not yet deeply inspected. |
Source register
| Source ID | Kind | Identity/location | Revision or capture | Evidence layer | Inspected scope | Citation anchors | Access gaps and conclusion prevented |
|---|---|---|---|---|---|---|---|
| SRC-1 | git | https://github.com/janyork/llm-wiki-cli |
e1be6ab30e83947e4b0dba97ba910acfe3bd9821 | implementation; doctrine/design; reported operation | Access root: /home/zby/llm/commonplace/.commonplace/worktrees/llm-wiki-cli-b297bf038927/related-systems/janyork--llm-wiki-cli. Complete tracked tree inventoried. Implementation: CLI entry/dispatch, store module composition, page mutation/read/search and ingest admission, temporal insertion, lifecycle strong-context selection, MCP server entry, pi adapter, work runner, learning forwarder and Tutor binary entry, replica supervisor, team server configuration, local viewer, admin knowledge browser, npm launcher, Compose and build script. Doctrine/design: full README.md, skills/using-lwc/SKILL.md, active-memory reference, Tutor skill, learning contracts and benchmark README. Reported operation: README's attributed benchmark description and limits only; stored result files not yet inspected. |
Implementation: CLI, store, pi consumer. Doctrine/design: core skill, learning contracts. Reported operation: README. Other commit-relative anchors in this member identify initial inspected paths at the same pin. | No repository access failure. Live hosts/models, external binaries/services, external Wiki and actual deployment state are outside the frozen source; no end-to-end behavioral, compliance, production reliability or causal-quality claim follows. Source tests and reported results are not an independently observed execution. |