Commit graph

33 commits

Author SHA1 Message Date
Andrey Avtomonov
7b52ff9bd0 docs: add cli command tree implementation plan 2026-05-13 00:36:19 +02:00
Luca Martial
950fa151ce
Merge pull request #26 from Kaelio/luca-martial/demo-data-wizard-ux
feat(cli): add demo guided tour with real Orbit project data
2026-05-12 01:06:45 -04:00
Luca Martial
b440c75092 docs: plan agent-friendly docs site 2026-05-11 16:38:15 -07:00
Luca Martial
8fdf578148 docs: design agent-friendly docs site 2026-05-11 16:30:47 -07:00
Luca Martial
e52713ca1e docs: add demo guided tour implementation plan
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-11 15:26:26 -07:00
Luca Martial
6e2a6b7611 docs: add demo guided tour design spec
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-11 14:34:07 -07:00
Andrey Avtomonov
1bd29c7eb1 Fix historic SQL ingest setup and progress 2026-05-11 22:35:07 +02:00
Andrey Avtomonov
f3f6b36551 Merge remote-tracking branch 'origin/main' into andreybavt/historic-sql-redesign 2026-05-11 20:52:19 +02:00
Andrey Avtomonov
fed5e6f89f docs(plans): add historic-sql pattern shard smoke/docs plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 20:29:08 +02:00
Andrey Avtomonov
1ba7be8f91 docs(plans): add historic-sql pattern workunit sharding plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 20:18:17 +02:00
Andrey Avtomonov
cb55a0d097 docs(plans): add historic-sql redaction hardening plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 20:08:36 +02:00
Andrey Avtomonov
f8312cf79a docs(plans): add historic-sql end-to-end retrieval acceptance plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:58:23 +02:00
Andrey Avtomonov
20061652df docs(plans): add historic-sql projection archive hardening plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:48:33 +02:00
Andrey Avtomonov
78e88a6aeb docs: refresh historic sql setup and smoke docs 2026-05-11 19:41:21 +02:00
Andrey Avtomonov
fc1fdb6bc9 docs(plans): add historic-sql docs/smoke/config-cleanup plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:37:32 +02:00
Andrey Avtomonov
83b6fd5bac docs(plans): add historic-sql cross-dialect readiness plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 19:22:58 +02:00
Andrey Avtomonov
f99f85361a docs(plans): add historic-sql skills/projection/cutover plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 18:39:18 +02:00
Andrey Avtomonov
3ada4601d1 docs(plans): add historic-sql unified hot-path plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 17:55:42 +02:00
Andrey Avtomonov
a1465502d4 docs(plans): add historic-sql search enrichment plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 17:20:48 +02:00
Andrey Avtomonov
a46563bb01 chore: move docs site workspace 2026-05-11 16:53:42 +02:00
Andrey Avtomonov
d73a54e8c7 docs(plans): add historic-sql foundations plan
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 16:40:07 +02:00
Andrey Avtomonov
2e10a2d0be
Draft historic-SQL ingestion redesign spec (#8)
Captures the design for replacing the current per-query, per-dialect
historic-SQL pipeline with a unified, LLM-driven ingest that feeds both
ktx wiki search (pattern pages) and ktx sl search (per-table usage in
_schema shards). Spec covers motivation, principles, architecture, hot
and cold paths, search-surface plumbing, schemas, configuration, cutover
plan, and rejected alternatives.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 16:14:14 +02:00
Andrey Avtomonov
9dad936ac7
feat: npm-managed Python runtime for @kaelio/ktx (#7)
* docs: add npm managed python runtime design

* build: add bundled python runtime wheel builder

* build: make local embedding dependencies optional

* build: bundle python runtime wheel in cli artifacts

* build: track bundled python runtime release artifact

* test: verify bundled python runtime wheel

* docs: add plan for bundled python runtime wheel

* test: cover managed python runtime lifecycle

* feat: add managed python runtime installer

* feat: add runtime command runner

* feat: expose runtime management commands

* test: verify managed python runtime commands

* docs: add plan for managed python runtime installer

* feat: add managed python command helper

* feat: use managed runtime for sl query compute

* feat: route sl query managed runtime policy

* docs: add plan for managed runtime sl query integration

* feat: add managed runtime daemon metadata

* feat: manage python daemon lifecycle

* feat: add runtime daemon start stop commands

* fix: verify managed runtime daemon lifecycle

* docs: add plan for managed runtime daemon lifecycle

* feat: add managed local embeddings config marker

* feat: add managed local embeddings daemon helper

* feat: use managed runtime for local embedding setup

* feat: pass managed runtime policy through setup

* docs: add plan for managed local embeddings runtime

* feat: read CLI package metadata dynamically

* feat: assemble public kaelio ktx npm package

* feat: release one public kaelio ktx npm artifact

* test: cover public kaelio ktx package invocations

* chore: verify public kaelio ktx package artifacts

* docs: add plan for public kaelio ktx npm package

* test: verify managed runtime in public package smoke

* test: finalize managed runtime release smoke

* docs: add plan for managed runtime release smoke

* test: specify local embeddings release smoke

* feat: add local embeddings runtime smoke

* chore: register local embeddings smoke

* fix: verify local embeddings smoke

* fix: restore artifact smoke python env helper

* docs: add plan for managed local embeddings release smoke

* refactor: share managed runtime install policy parsing

* feat: use managed runtime for agent semantic queries

* feat: use managed runtime for MCP semantic compute

* docs: add plan for managed agent and MCP semantic runtime

* feat(cli): add managed daemon HTTP helpers

* feat(cli): route local adapters through managed daemon

* feat(cli): use managed daemon for ingest helpers

* feat(cli): pass managed daemon options to scan

* feat(context): pass MCP ingest pull config options

* feat(cli): pass managed daemon options to serve ingest

* test: verify managed local ingest daemon runtime

* docs: add plan for managed local ingest daemon runtime

* docs: align managed runtime examples

* docs: add plan for managed runtime docs cleanup

* test: cover published package runtime smoke commands

* test: validate published package smoke outputs

* docs: add plan for published package runtime smoke

* build: stamp public npm package version

* release: add npm public release policy

* release: add guarded npm publish script

* release: document public npm release handoff

* docs: add plan for public npm release handoff

* test: cover managed runtime prune in package smoke

* docs: document managed runtime prune

* docs: add plan for managed runtime prune smoke and docs

* chore: encode uv runtime prerequisite policy

* fix: clarify missing uv runtime error

* docs: document uv runtime prerequisite

* docs: add plan for uv runtime prerequisite contract

* refactor: limit release artifacts to public package runtime

* chore: align release policy with bundled runtime wheel

* docs: describe single public runtime artifact surface

* test: verify single public runtime artifact contract

* docs: add plan for single public runtime artifact cleanup

* fix: align local embeddings smoke with public version

* docs: add plan for local embeddings smoke public version

* release: soft-launch as @kaelio/ktx@0.1.0-rc.0 on next tag

Publish target moves to the pre-release version 0.1.0-rc.0 under the next
dist-tag so npm install @kaelio/ktx (which resolves to latest) does not
pick up the soft-launch build. Users opt in via @kaelio/ktx@next.

* Fix release script boundary checks

* Remove PostHog from public package bundle
2026-05-11 15:50:34 +02:00
Luca Martial
572d515db0 feat(docs): add Fumadocs site workspace 2026-05-11 01:08:31 -07:00
Luca Martial
cb9ab25456 docs: add title attributes to config code blocks
Triggers VS Code tab styling on the docs' YAML/config blocks
where surrounding prose names the file. Mechanical, ~1 edit
across the guides section (building-context.mdx); primary-sources.mdx
and context-sources.mdx already had title= on their Connection config
blocks, so only the prose-named semantic source output example needed
updating.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 00:45:43 -07:00
Luca Martial
c54b5ca4cd feat(docs): style Mode B (filename tab) and Mode C (minimal)
Mode B kicks in when a code block has a title= attribute.
Mode C is the default for unlabeled non-shell blocks: hover
reveals the language label and copy button.

Reduced-motion media query extended to cover the new transitions
and the sidebar chevron rotation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 00:42:31 -07:00
Luca Martial
86fc6aa463 feat(docs): style Mode A (terminal) code blocks
Dark frame in both themes, traffic-light dots, zsh/title label,
copy button in the header. Wizard-glyph content (◆ ◇) also routes
through this mode.
2026-05-11 00:39:14 -07:00
Luca Martial
cc033f1ce7 feat(docs): wire CodeBlock into MDX components map
All <pre> elements in docs MDX now render through CodeBlock,
which selects one of three modes based on language and title.
CSS styling for each mode follows.
2026-05-11 00:37:12 -07:00
Luca Martial
3a3dfeeeba feat(docs): add CodeBlock with three context-aware modes
- Mode A (Terminal): bash/sh languages or wizard-glyph content
- Mode B (VS Code tab): blocks with a title attribute
- Mode C (Minimal): everything else

Component renders only structural markup; CSS for each mode is
added in the following commits.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 00:35:14 -07:00
Luca Martial
7607e9fd40 feat(docs): add CopyButton component
Reusable copy-to-clipboard button with animated check on success.
Used by CodeBlock for all three modes.
2026-05-11 00:33:10 -07:00
Luca Martial
ea2d002a69 fix(docs): tighten sidebar selectors + add focus-visible
- Scope section trigger rules to div[data-state]:not([class]) so they
  don't bleed onto other Radix collapsibles inside #nd-sidebar.
  Fumadocs 15 section wrapper divs are bare (no class, no id); content
  panels and popovers always carry a class attribute.
- Add focus-visible rings for section buttons and page links
  (a11y gap from code review).
- Add !important to margin-top for consistency with the
  surrounding padding overrides.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 00:31:58 -07:00
Luca Martial
0049a47cc6 feat(docs): typographic sidebar with active rail
Uppercase tracked section labels (Outfit, 11px), 1px dividers
between sections, filled-background + 2px primary rail for the
active page. Chevron rotates smoothly on collapse toggle.
Pure CSS — Fumadocs' built-in folder collapsing handles state.
2026-05-11 00:27:11 -07:00
Luca Martial
399bad0e0b feat(docs): collapse sidebar sections by default
Activates fumadocs' built-in collapse on every section. Only the
section containing the current page expands; others stay collapsed
until the user clicks them. Foundation for the typographic sidebar
pass in the next commit.
2026-05-11 00:23:18 -07:00