docs: clarify Windows C++ compiler requirements for local builds - #52
Open
fy2ne wants to merge 80 commits into
Open
docs: clarify Windows C++ compiler requirements for local builds#52fy2ne wants to merge 80 commits into
fy2ne wants to merge 80 commits into
Conversation
Fix catalog import checkpoint state
Default search now favors primary sessions so human intent and decisions stay prominent. --include-subagents remains the explicit path for implementation details, review notes, and failure traces while the old primary-only input is kept as hidden compatibility.
ctx_files_touched now resolves provider/session/history-record metadata when a touch row is associated only by source_id, matching the existing --file search fallback. The schema migration recreates stable views without reimporting provider transcripts.
Adds a dedicated embedded SQL guide with stable view schemas, examples, limits, and output formats. Exact docs topic matches now rank first so 1. storage - Storage And Privacy score 33 | Local storage layout, command read/write behavior, privacy, and upgrades. inspect: ctx docs show storage 2. cli-reference - CLI Reference score 24 | Command and option reference for the installed ctx CLI. inspect: ctx docs show cli-reference 3. json-contracts - JSON Contracts score 15 | Machine-readable JSON output contracts for scripts and integrations. inspect: ctx docs show json-contracts 4. search - Search score 3 | Search behavior, filters, result metadata, and agent-readable output. inspect: ctx docs show search 5. agent-usage - Agent Usage score 2 | How agents should search, inspect, cite, and report local history. inspect: ctx docs show agent-usage 6. getting-started - Getting Started score 2 | Install ctx, set up local storage, import history, and run first searches. inspect: ctx docs show getting-started 7. limitations - Limitations score 1 | Provider, import, search, retrieval, and operations limits. inspect: ctx docs show limitations 8. provider-support - Provider Support score 1 | Current provider support matrix and promotion evidence requirements. inspect: ctx docs show provider-support 9. providers - Providers score 1 | Supported local provider imports and fidelity rules. inspect: ctx docs show providers points agents directly at the advanced-query reference.
Adds status/source checks, read-only search examples, verbose output guidance, the new primary-vs-subagent search default, and a SQL escape hatch so packaged agents can self-serve advanced history queries.
Search/show/locate now accept unambiguous 8+ character ctx ID prefixes, matching the short IDs displayed in compact output. Help and docs now explain OR-style --term broadening, touched-file --file semantics, workspace matching, and valid event types.
Docs search now favors exact topic/tag matches, ignores short substring noise, and returns next-step suggestions when no strong topic matches. This prevents agents from treating low-confidence docs hits as authoritative.
ctx doctor can now emit opening/checking/done progress to stderr, which makes slow SQLite integrity checks visible without polluting JSON stdout. This keeps health checks scriptable while making interactive runs less opaque.
ctx docs show now points agents toward nearby topics, ctx docs list, and ctx docs search when a topic id is wrong. This keeps the built-in docs usable when the agent has no external documentation.
Update crate versions, Cargo.lock, Bazel module metadata, and public artifact version assertions so the 0.13 release branch builds and verifies binaries as ctx 0.13.0.
Add first-class embedded docs topics for ctx docs, MCP, and managed upgrades so agents can discover these newer command surfaces with ctx docs show/search instead of digging through the full CLI reference.
The hidden --primary-only compatibility flag still narrows search, but search packets no longer serialize primary_only. Structured output now presents one current model: default primary-agent results plus include_subagents when explicitly broadened.
Document the difference between kebab-case provider CLI values and provider IDs shown in JSON or SQL views. This avoids changing stable stored identifiers while reducing confusion around multiword providers.
Use the derived Default implementation for SearchFilters after the serialization cleanup. This removes a hand-written default path and keeps clippy clean for release checks.
Record-level fallback search now applies the same session-scope rules to individual sections before matching, snippets, and citations are produced. This prevents mixed primary/subagent records from returning child-session hits unless --include-subagents is set, while explicit --session still works for known subagent IDs.
Adds focused public ctx coverage for signed release metadata parsing, endpoint validation, provider-session exclusion, and archive/blob fail-closed validation.
…story Add native personal agent history providers
release: bump ctx to 0.15.0
…ort-path fix(cli): improve error for nonexistent import paths
Bump ctx to 0.19.0 for the Pi session directory release.
Add Shelley as a native ctx history/import provider using the shelley_sqlite source format. Supports explicit import and default discovery, normalizes Shelley SQLite conversations/messages into ctx sessions/events with stable cursors, metadata, citations, robust JSON text extraction, and read-only SQLite handling. Includes provider docs, support matrix updates, discovery tests, corrupt database coverage, idempotent re-import tests, and provider filtering/search coverage.
Harden CLI and provider import boundaries
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hi maintainers
I was setting up the project locally on Windows and ran into the infamous
link.exe not found/gcc.exe missingerrors when runningcargo build.It took me a minute to realize that because
ctxrelies onrusqlite, a C-compiler is strictly required on the machine to compile the bundled SQLite C code.To save future Windows contributors from hitting this same roadblock, I've added a small "Building from source" section to the README. It explicitly lists the Microsoft C++ Build Tools requirement and includes a quick Mermaid flowchart to visually explain why the compiler is needed.
Hope this is a helpful addition! Let me know if you'd like me to tweak any of the wording.