Understand any codebase instantly. System intelligence for codebases, built for humans and AI.
TypeScript aiai-memoryclaude-codeclicode-analysiscode-mappingcode-memorycodebase-understandingcodexdeveloper-toolsllmopenclawpersistent-memoryprogram-analysissoftware-architecturesystem-intelligencesystem-mapping
docs: gate merges on the docs build, label planning endpoints, settle the language count
KageBinary49be70425c0e
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.ymlindex c1d20118..b2a634fd 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -560,6 +560,29 @@ jobs:- name: Check markdown linksrun: node ix-cli/scripts/check-links.mjs+ # The docs site renders docs/llm-format.md, docs/api/ and+ # skills/ix/references/flags.md at build time, so a change to any of them can+ # break it without touching docs-site/. In CI Passed's `needs` so that gates+ # the merge; it lived in its own workflow, which branch protection ignores.+ docs-site:+ name: Build docs site+ runs-on: ubuntu-latest+ timeout-minutes: 10+ defaults:+ run:+ working-directory: docs-site+ steps:+ - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1+ with:+ persist-credentials: false+ - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0+ with:+ node-version: "22"+ cache: npm+ cache-dependency-path: docs-site/package-lock.json+ - run: npm ci+ - run: npm run build+# One stable required-status-check context. Branch protection requires only# this job, so the matrix can be reshaped without orphaning required checks.# Fails if any upstream job failed OR was skipped/cancelled.@@ -596,7 +619,7 @@ jobs:ci-success:name: CI Passedif: always()- needs: [static, test, e2e, api-parity, doc-parity, links, harness-install-smoke, harness-install-smoke-windows]+ needs: [static, test, e2e, api-parity, doc-parity, links, docs-site, harness-install-smoke, harness-install-smoke-windows]runs-on: ubuntu-lateststeps:- name: Verify all required jobs succeeded@@ -607,6 +630,7 @@ jobs:echo "api-parity=${{ needs.api-parity.result }}"echo "doc-parity=${{ needs.doc-parity.result }}"echo "links=${{ needs.links.result }}"+ echo "docs-site=${{ needs.docs-site.result }}"echo "harness-install-smoke=${{ needs.harness-install-smoke.result }}"echo "harness-install-smoke-windows=${{ needs.harness-install-smoke-windows.result }}"[ "${{ needs.static.result }}" = "success" ] \@@ -615,5 +639,6 @@ jobs:&& [ "${{ needs.api-parity.result }}" = "success" ] \&& [ "${{ needs.doc-parity.result }}" = "success" ] \&& [ "${{ needs.links.result }}" = "success" ] \+ && [ "${{ needs.docs-site.result }}" = "success" ] \&& [ "${{ needs.harness-install-smoke.result }}" = "success" ] \&& [ "${{ needs.harness-install-smoke-windows.result }}" = "success" ]diff --git a/.github/workflows/docs-site.yml b/.github/workflows/docs-site.ymldeleted file mode 100644index 4669772a..00000000--- a/.github/workflows/docs-site.yml+++ /dev/null@@ -1,46 +0,0 @@-name: Docs site--on:- push:- branches: [main]- paths:- - 'docs-site/**'- - 'docs/**'- - 'skills/ix/references/**'- - '.github/workflows/docs-site.yml'- pull_request:- branches: [main]- paths:- - 'docs-site/**'- - 'docs/**'- - 'skills/ix/references/**'- - '.github/workflows/docs-site.yml'--permissions:- contents: read--concurrency:- group: docs-site-${{ github.workflow }}-${{ github.ref }}- cancel-in-progress: true--jobs:- # The site renders docs/llm-format.md, docs/api/ and skills/ix/references/flags.md- # at build time, so a change to any of them can break it without touching docs-site/.- build:- name: Build docs site- runs-on: ubuntu-latest- timeout-minutes: 10- defaults:- run:- working-directory: docs-site- steps:- - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1- with:- persist-credentials: false- - uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0- with:- node-version: "22"- cache: npm- cache-dependency-path: docs-site/package-lock.json- - run: npm ci- - run: npm run builddiff --git a/CLAUDE.md b/CLAUDE.mdindex ed6a868d..e0879cc1 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -10,7 +10,7 @@ backend is NOT in this repo — it is the released Docker image running at| Path | What it is ||---|---|| `ix-cli/` | The `@ix/cli` TypeScript package — command routing (`src/cli/`), registration hub (`src/cli/register/oss.ts`), HTTP client (`src/client/api.ts`), response types (`src/client/types.ts`) |-| `core-ingestion/` | Tree-sitter parser/classifier (26 languages) |+| `core-ingestion/` | Tree-sitter parser/classifier (27 languages) || `skills/ix/` | The agent skill this project ships: `SKILL.md`, `references/` (commands, flags, output-formats, troubleshooting), `scripts/` (bootstrap.sh/ps1) || `docs/` | `api/` (HTTP API reference + OpenAPI spec), `llm-format.md`, `prerequisites.md` || `scripts/` | `bootstrap.sh` (first-run), `install-skill.sh` (deploy skill to `~/.claude/skills` + `~/.agents/skills`) |diff --git a/docs-site/src/content/docs/guides/everyday-workflows.md b/docs-site/src/content/docs/guides/everyday-workflows.mdindex 874c1f87..b5f24acb 100644--- a/docs-site/src/content/docs/guides/everyday-workflows.md+++ b/docs-site/src/content/docs/guides/everyday-workflows.md@@ -74,8 +74,14 @@ into a prompt or read by an agent.ix context IngestionService --format llmix context IngestionService --max-tokens 6000 # a larger evidence budget (default 3000)ix context IngestionService --save ingest-review # keep it to resume or diff later+ix context --from-issue issue.md # start from a bug report instead of a name+gh issue view 42 --json body -q .body | ix context --from-issue -```+With `--from-issue`, Ix resolves the file paths (including those in stack traces and GitHub links) and code names the+issue mentions to up to three definitions, builds the bundle around the first, and ranks the other files by how well+they match the issue's text. When nothing resolves, it starts from the best-matching file.+## Tips- Decompose a big question into several targeted commands. Commands answer structural questions, not free-formdiff --git a/docs/api/openapi.yaml b/docs/api/openapi.yamlindex 099de414..55f3476e 100644--- a/docs/api/openapi.yaml+++ b/docs/api/openapi.yaml@@ -25,6 +25,10 @@ tags:- name: search- name: entities- name: planning+ description: >-+ Goals, truth statements and decisions. The OSS backend serves these+ endpoints, but the ix commands that read and write them (goal, truth,+ decide, decisions and the rest) are part of Ix Pro.- name: patches- name: analysis- name: statsdiff --git a/skills/ix/SKILL.md b/skills/ix/SKILL.mdindex 21112044..eb508262 100644--- a/skills/ix/SKILL.md+++ b/skills/ix/SKILL.md@@ -9,7 +9,7 @@ metadata:# Ix — Persistent Codebase Map-Ix parses a repository with tree-sitter (26 languages) into a graph of symbols,+Ix parses a repository with tree-sitter (27 languages) into a graph of symbols,calls and imports, kept in a local backend (ArangoDB via Docker) and persistedbetween sessions. Query it for structural answers — what a symbol is, what callsit, how a flow moves, what a change breaks, which files carry the most weight,