Skip to content

armgit / Ix

Public Imported from GitHub
0

Understand any codebase instantly. System intelligence for codebases, built for humans and AI.

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.yml
index c1d20118..b2a634fd 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -560,6 +560,29 @@ jobs:
- name: Check markdown links
run: 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 Passed
if: 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-latest
steps:
- 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.yml
deleted file mode 100644
index 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 build
diff --git a/CLAUDE.md b/CLAUDE.md
index 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.md
index 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 llm
ix 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-form
diff --git a/docs/api/openapi.yaml b/docs/api/openapi.yaml
index 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: stats
diff --git a/skills/ix/SKILL.md b/skills/ix/SKILL.md
index 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 persisted
between sessions. Query it for structural answers — what a symbol is, what calls
it, how a flow moves, what a change breaks, which files carry the most weight,