Understand-Anything

feat(understand): auto-detect conversation language on first run

When /understand runs with no --language flag and no stored outputLanguage,
step 3.6 now infers the conversation language and — only when it is non-English
— confirms once before generating, then persists the choice to config.json.
English conversations keep the exact same silent `en` path; --language flag and
stored config still take priority. README documents the behavior; version
bumped 2.7.5 -> 2.7.6 across all five manifests (user-visible behavior change).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Bozheng Long · 2026-06-03 21:19:52 +08:00

92e76190aa

Merge pull request #350 from tirth8205/chore/repo-hygiene

chore(repo): community templates, CoC, SECURITY, package metadata, CI on main (#248, #249, #251, #252).

ZebangCheng · 2026-06-02 17:49:02 +08:00

025b884935

Merge pull request #343 from xiazl1993/chore/cleanup-gitignore-patterns

chore: clean up duplicate gitignore patterns

ZebangCheng · 2026-06-02 17:47:24 +08:00

f65013e689

Merge pull request #332 from ZebangCheng/fix/phase7-preserve-scan-result

fix(skill): preserve scan-result.json across Phase 7 cleanup for incremental runs (#293)

Yuxiang Lin · 2026-06-01 17:53:12 +08:00

e5dded6215

chore(repo): add issue/PR templates, SECURITY.md, CoC, package metadata; widen CI triggers

Closes a cluster of community-profile gaps (#248, #249, #251, #252) in one
PR rather than four micro-PRs that all touch the same surface area.

### Templates (#251, #252)

- .github/ISSUE_TEMPLATE/bug_report.yml — required fields for repro
  (plugin version, platform, OS, project language, file count); the four
  pieces of context that are missing from ~every current bug report.
- .github/ISSUE_TEMPLATE/feature_request.yml — leads with the *problem*
  rather than the proposed solution, which keeps maintainer review focused
  on whether to solve, not just how.
- .github/ISSUE_TEMPLATE/question.yml — separate from bug to keep the
  bug queue triagable.
- .github/ISSUE_TEMPLATE/config.yml — disables blank issues and routes
  general discussion to README + Discussions.
- .github/PULL_REQUEST_TEMPLATE.md — includes the version-bump checklist
  that CLAUDE.md says must stay in sync across 5 manifests; otherwise
  every contributor learns this rule by getting their PR bounced.

### Community files

- CODE_OF_CONDUCT.md — short, project-specific document that names the
  expectations and reporting path. Not a verbatim Contributor Covenant
  to keep it readable.
- SECURITY.md — describes the project's local-only threat model
  explicitly so reporters know what's in / out of scope before they
  spend time on a writeup. Points at GitHub private vulnerability
  reporting as the primary channel.

### CI (#249)

- ci.yml now also runs on pushes to main, not only PRs. Without this,
  a direct push to main (which happens when maintainers merge a PR
  branch locally) doesn't trigger CI, so a regression can land green-
  looking and stay broken for days.
- Added a concurrency group that cancels stale runs for the same ref.
  Saves runner minutes and keeps the per-ref status meaningful.
- Used `github.ref` (a controlled value), not user-controlled input,
  so no script-injection surface.

### package.json (#248)

- Added description, license, repository, bugs, homepage, keywords —
  the standard set for npm package discoverability and so GitHub's
  community-profile check shows the project at 100%.

Tirth Kanani · 2026-05-31 21:29:13 +01:00

aef940fcde

chore: clean up duplicate gitignore patterns

summer · 2026-05-31 23:14:38 +08:00

d2d4d23156

fix(skill): preserve scan-result.json across Phase 7 cleanup for incremental runs (#293 )

Zebang Cheng · 2026-05-29 15:33:31 +00:00

928b997c57

Merge pull request #235 from ZebangCheng/feat/add-trae-platform

feat(install): add Trae (ByteDance AI IDE) platform support (#229)

ZebangCheng · 2026-05-26 13:09:57 +08:00

26edf61856

Merge pull request #227 from ZebangCheng/fix/tsconfig-path-leading-dot-slash

fix(extract-import-map): normalize tsconfig path-alias candidates with leading "./" (#214)

ZebangCheng · 2026-05-26 13:09:25 +08:00

d40d6b6204

Merge pull request #208 from evanclan/docs/cursor-manual-install-i18n

docs(readme): add Cursor manual install fallback to 7 translated READMEs

Yuxiang Lin · 2026-05-26 08:03:39 +08:00

1a16e4de61

Merge pull request #231 from atlas-architect/fix/scan-project-non-ascii-paths

fix(scan-project): preserve non-ASCII path bytes via `git ls-files -z`

Yuxiang Lin · 2026-05-26 08:02:54 +08:00

44d1d59028

fix(scan-project): preserve non-ASCII path bytes via git ls-files -z

`enumerateViaGit` ran `git ls-files -co --exclude-standard` (newline-separated
output) and then `split('\n').map(trim)` on the result. Without `-z`,
`git ls-files` C-escapes any byte outside the locale's "safe" set and wraps
the path in double quotes — for example, a directory named `30. 🏗️ docs/`
comes back as `"30. \360\237\217\227\357\270\217 docs/"`. Downstream
consumers then can't round-trip those octal-quoted strings to real disk
paths, so every file under such directories is silently dropped from the
scan.

This is particularly biting on Windows (where the issue surfaces even with
UTF-8 locale settings) and for any project that uses emoji, accented
characters, or CJK codepoints in directory names — which is increasingly
common in design/spec/journal trees.

The fix is to use `-z` (NUL-terminated output), the same approach git
itself documents for downstream consumers (e.g. `xargs -0`). NUL-separated
chunks are raw bytes, so every codepoint round-trips back to its real disk
path on every platform. Split on `\0` instead of `\n`; drop the now-
unnecessary `.trim()`.

Verified on a real project with emoji-prefixed directory names:

  bare `git ls-files`:
    "30. \360\237\217\227\357\270\217\360\237\247\231\342\200\215..."

  `git ls-files -z`:
    30. 🏗️🧙‍♂️🔮 BD-CCSP/01. Demo's/DEMO--...

Discovered during a multi-agent scan of an Atlas Intelligence spoke repo;
~33 design-intent files in `30. 🏗️ BD-{app}/` directories were silently
dropped per scan. Full report: atlas-intelligence-io/fleet-feedback#491.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Adam Herring · 2026-05-25 11:09:20 -07:00

b4d856d3b8

feat(install): add Trae (ByteDance AI IDE) platform support (#229 )

Zebang Cheng · 2026-05-25 15:45:48 +00:00

b4b599e214

fix(extract-import-map): normalize tsconfig path-alias candidates with leading "./" (#214 )

Zebang Cheng · 2026-05-25 14:02:01 +00:00

d9ae3c290c

docs(readme): add Cursor manual install fallback to 7 translated READMEs (#172 )

PR #199 documented the community-reported Cursor Settings → Plugins
workaround in README.md only; the seven READMEs/* locale files still
said auto-discovery always works. Mirror that fallback here so non-English
readers hit the same fix without hunting issue #172.

Evan Alferez · 2026-05-25 09:20:33 +09:00

47e9001634

Merge pull request #200 from AsimRaza10/fix/agent-model-omit-inherit

fix(agents): omit `model: inherit` so non-Claude tools don't see a bad model id

Yuxiang Lin · 2026-05-24 21:12:57 +08:00

470cc01dc5

docs(readme): note Cursor manual install fallback when auto-discovery fails (#199 )

Several users have reported that cloning the repo and opening it in Cursor
doesn't always trigger auto-discovery of the .cursor-plugin manifest. Add
the community-reported workaround (Cursor Settings → Plugins, paste repo
URL) to the Cursor section so it isn't only discoverable from issue
threads.

Closes #172

Yuxiang Lin · 2026-05-24 20:23:10 +08:00

a8a115dc36

Merge pull request #204 from Lum1104/feat/semantic-batching-and-output-chunking

fix(#159): semantic batching + bundled importMap + Phase 1 speedup

Yuxiang Lin · 2026-05-24 20:12:14 +08:00

a59a573a1d

fix(agents): omit model: inherit so non-Claude tools don't see a bad model id

`model: inherit` is a Claude Code-specific keyword that means "use the
parent session's model." Other tools that read the same agent frontmatter
(opencode, codex, etc.) don't understand it and instead try to use
`inherit` as a literal model id, which the configured provider rejects.

Reproduction (from #167): opencode + deepseek runs `/understand`, the
project-scanner subagent dispatches with `model: inherit`, deepseek
returns `ProviderModelNotFoundError`, and the pipeline halts on every
subagent dispatch.

With the field omitted, each platform falls back to its own configured
default:
- Claude Code: user's default subagent model
- opencode / codex / etc.: globally configured model

Note for Claude Code Opus users: subagents will no longer auto-inherit
the Opus session model. If you want the previous behavior, set your
default subagent model globally — that single setting now controls all
nine agents.

Closes #167

Asim Raza · 2026-05-24 10:50:26 +05:00

0566ea8b6b

docs(readme): note Cursor manual install fallback when auto-discovery fails

Several users have reported that cloning the repo and opening it in Cursor
doesn't always trigger auto-discovery of the .cursor-plugin manifest. Add
the community-reported workaround (Cursor Settings → Plugins, paste repo
URL) to the Cursor section so it isn't only discoverable from issue
threads.

Closes #172

Asim Raza · 2026-05-24 10:43:18 +05:00

0db7b3c795

Merge pull request #186 from AsimRaza10/fix/tailwind-source-detection

fix(dashboard): explicit @source for Tailwind v4 (fixes #179)

Yuxiang Lin · 2026-05-24 10:10:58 +08:00

42d70c3f9c

Merge pull request #187 from devangpratap/fix/progress-reporting

fix(ux): add progress reporting to /understand pipeline

Yuxiang Lin · 2026-05-24 09:58:52 +08:00

be458664c1

docs(readme): document incremental updates, subdir scoping, and tree-sitter+LLM split

Add to all 8 READMEs (English + 7 translations):
- "Keep learning" section gets inline commands for incremental re-runs, the --auto-update post-commit hook, and scoping /understand to a subdirectory for huge monorepos
- "Under the Hood" gets a new "Tree-sitter + LLM hybrid" subsection explaining the deterministic-vs-semantic split that powers the pipeline

Lum1104 · 2026-05-24 09:34:54 +08:00

dbba0703a9

fix(ux): add progress reporting to /understand pipeline

Adds phase status lines, batch progress with total count, and phase
completion confirmations to the skill definition. Users now see
[Phase N/7] headers and Batch X/N during analysis instead of
unnumbered batch lines with no context.

Fixes #182

devangpratap · 2026-05-23 14:18:26 -04:00

31ae12b65c

fix(dashboard): add explicit @source for Tailwind v4 detection

Tailwind v4's default source detection walks the nearest .git and
collects tracked files via git ls-files. When the dashboard sources
sit inside a gitignored subtree of an ancestor repo (e.g. the default
marketplace install path ~/.claude/plugins/cache/, which is ignored by
~/.claude/.gitignore), detection returns 0 files and the Oxide engine
skips all utility generation — the dashboard renders unstyled.

Adding explicit @source directives is the supported Tailwind v4 escape
hatch and is a no-op for installs where automatic detection works.

Verified: built CSS bundle jumps from ~9 KB to ~55 KB and utility
classes (.flex, .grid, .absolute, .w-full, .h-full) are present.

Fixes #179

Asim Raza · 2026-05-23 18:23:17 +05:00

96c412bcc1

Merge pull request #171 from Derrick-xn/docs/update-skill-graph-reference

docs(skills): update graph structure references

Yuxiang Lin · 2026-05-23 16:10:55 +08:00

35699dd82b

Merge pull request #177 from vedrao/fix/security-astro-vite-cve-bumps

chore(deps): bump astro to 6.3.7 and dashboard vite to 6.4.2 for security fixes

Yuxiang Lin · 2026-05-23 16:05:54 +08:00

58f66be006

chore(dependencies): update astro and vite versions in package.json and pnpm-lock.yaml

Bumps astro to version 6.3.7 and vite to version 6.4.2 across relevant package files to ensure compatibility and access to the latest features.

Ved Prakash · 2026-05-23 15:58:37 +08:00

4ef12f39a6

Merge pull request #161 from okwn/contrib/understand-anything/eslint-tooling

chore: add ESLint tooling with TypeScript support

Yuxiang Lin · 2026-05-23 15:47:52 +08:00

4bd6f78dff

chore(lint): switch to recommended baseline, fix errors, wire into CI

- typescript-eslint preset: strict -> recommended for a usable first-pass
  baseline (per PR discussion); ratchet up in a follow-up.
- Drop the projectService/parserOptions block. Neither `recommended` nor
  `strict` is type-aware, so it was unused; removing it also avoids the
  pnpm-workspace tsconfig-resolution failure mode flagged in review.
- Add Node + browser globals via the `globals` package so .mjs scripts and
  the dashboard stop hitting `no-undef`.
- Expand ignores: built bundles (**/public/**), Astro generated (.astro/),
  and .private/ (eval scratch). Cuts 2400+ errors in vendored output.
- Allow `_`-prefixed unused vars/args/caught errors; skip irregular
  whitespace inside comments (json-parser intentionally embeds ZWSP-escaped
  block-comment examples in JSDoc).
- Fix the residual 13 genuine errors: drop dead imports/vars, replace
  two `as any[]` in schema.ts with `Array<Record<string, unknown>>`,
  drop unused destructure in change-classifier, drop unused catch binding
  in extract-structure.mjs.
- Add EOF newline to eslint.config.mjs.
- Refresh pnpm-lock.yaml.
- Add `pnpm lint` step to .github/workflows/ci.yml so the tooling
  actually enforces something.

pnpm lint now exits 0 locally; 33+13 test files / 1445 tests still pass.

Lum1104 · 2026-05-23 15:26:39 +08:00

a1261b4883

Merge pull request #175 from zichen0116/fix/wrong-github-url-in-footer

fix: correct GitHub URL in onboarding guide footer

Yuxiang Lin · 2026-05-22 22:06:27 +08:00

f51727526d

fix: correct GitHub URL in onboarding guide footer

The generated onboarding markdown linked to a nonexistent repository
(anthropics/understand-anything) instead of the actual project URL
(Lum1104/Understand-Anything).

Ubuntu · 2026-05-22 20:23:21 +08:00

11c5123d61

docs(skills): update graph structure references

初晨 · 2026-05-22 12:08:44 +08:00

a30c226bf4

Merge pull request #170 from Lum1104/feat/trendshift-badge

feat(readme,homepage): add Trendshift trending badge

Yuxiang Lin · 2026-05-22 08:28:45 +08:00

17eed78876

feat(readme,homepage): add Trendshift badge

Adds the Trendshift trending-repository badge just below the tagline on the
English README and all 7 localized variants, and to the homepage hero between
the action row and the Enterprise pill.

Lum1104 · 2026-05-22 08:27:43 +08:00

33728f04a6

Merge pull request #164 from Lum1104/feat/community-video

feat(readme,homepage): add Community section with Better Stack walkthrough video

Yuxiang Lin · 2026-05-21 20:01:23 +08:00

ea4d17b484

feat(readme,homepage): add Community section featuring Better Stack walkthrough video

Adds a Community section near the end of README (English + 7 localized
variants) and a CommunityVideo component on the homepage embedding the
YouTube walkthrough by Better Stack. Section invites future video / blog /
tutorial contributions to be featured here.

Lum1104 · 2026-05-21 19:57:09 +08:00

db94d066a8

Merge pull request #163 from Lum1104/fix/extract-structure-symlink-isCli

fix(skills/understand): extract-structure isCli silently no-ops via symlinked SKILL_DIR

Yuxiang Lin · 2026-05-21 19:40:01 +08:00

300056e789

chore(release): bump version to 2.7.4

Lum1104 · 2026-05-21 19:36:17 +08:00

d14d6f8f96

fix(skills/understand): canonicalize isCli paths so symlinked SKILL_DIR runs main()

import.meta.url resolves through symlinks but pathToFileURL(process.argv[1])
preserves them, so extract-structure.mjs silently exited 0 without writing
output when invoked via the plugin's symlinked install path — the documented
Claude Code / Copilot CLI layout. Compare both sides via realpathSync and add
a post-write existence assertion plus caller-side guidance in the agent.

Closes #162

Lum1104 · 2026-05-21 19:36:14 +08:00

8a78c94fc6

chore: add ESLint tooling with TypeScript support

The repository has a pnpm lint script running 'eslint .' but ESLint
and typescript-eslint were not listed in devDependencies.

Added:
- eslint (^9.0.0)
- @eslint/js (^9.0.0)
- typescript-eslint (^8.0.0)

Added eslint.config.mjs with flat config (ESLint 9+) using
typescript-eslint strict rules. Ignores node_modules, dist, build,
and framework-specific output directories.

okwn · 2026-05-21 09:15:15 +00:00

1bbfe99c64

Merge pull request #155 from nieao/feat/onboarding-overlay

feat(dashboard): first-visit onboarding overlay

Yuxiang Lin · 2026-05-21 11:09:34 +08:00

58411ac1f7

refactor(onboarding): theme tokens, lifted state, a11y

- Replace hardcoded hex with var(--color-*) and CJK font stacks with
  var(--font-sans) / var(--font-heading) so the overlay tracks the theme
  picker and uses the project's typography (DM Serif Display).
- Lift dismiss/visibility state to Dashboard (shouldShowOnboarding +
  showOnboarding useState + dismissOnboarding callback). Gate the
  Suspense mount with a boolean so the lazy chunk is only fetched on
  first visit, matching the PathFinderModal / KeyboardShortcutsHelp
  mount pattern.
- Add capture-phase Escape handler (stopPropagation prevents the global
  shortcut chain from also firing) and role="dialog" / aria-modal /
  aria-labelledby on the card for screen readers.

Lum1104 · 2026-05-21 11:07:02 +08:00

9dfcce73a5

fix(onboarding): include class/function in node-type description

Schema (packages/core/src/schema.ts) defines node types: file, function,
class, module, concept, config, document, ... The welcome step body only
listed "file, concept, entity, claim", missing the most common code-side
types. Updated all 6 locales (en / zh / zh-TW / ja / ko / ru) to mention
file / class / function from code plus concept / entity / claim from the
knowledge wiki.

Lum1104 · 2026-05-21 11:06:54 +08:00

a29585874e

fix(onboarding): wire to i18n + add missing ua-fade-in keyframes

- Replace hardcoded Chinese strings with t.onboarding.* via useI18n
- Add `onboarding` namespace to en / zh / zh-TW / ja / ko / ru locales
- Inject @keyframes ua-fade-in (was referenced in inline style but
  never defined, so the overlay popped in instead of fading)

Lum1104 · 2026-05-21 10:56:10 +08:00

8f85b85679

Merge branch 'main' into feat/onboarding-overlay

Lum1104 · 2026-05-21 10:33:16 +08:00

cd09d4fe09

chore: remove Product Hunt promo from README and homepage hero

Lum1104 · 2026-05-20 08:53:03 +08:00

57a25ed4aa

feat(i18n): add Russian language support

Lum1104 · 2026-05-19 15:01:43 +08:00

v2.7.3 9d1318a0e7

chore(release): bump version to 2.7.3

Ships the fingerprints baseline fix (e7af9ae): every install since
2.7.0 had a broken Phase 7 step 2.5 that threw TypeError on the first
/understand run and left fingerprints.json empty/missing, which made
every subsequent auto-update escalate to FULL_UPDATE. This release
replaces the LLM-written script with a bundled build-fingerprints.mjs
and reorders Phase 7 to write fingerprints before meta.json.

Anyone upgrading from 2.7.0–2.7.2 should re-run /understand --full
to regenerate a valid baseline.

Lum1104 · 2026-05-18 10:13:22 +08:00

0e39f227a4

fix(skills/understand): bundle build-fingerprints.mjs and reorder Phase 7

The Phase 7 step 2.5 code example in SKILL.md called
buildFingerprintStore() with 2 arguments, but the real signature
requires 4 (projectDir, filePaths, registry: PluginRegistry,
gitCommitHash: string). It also omitted the required
`await TreeSitterPlugin.init()`. Any LLM following the example
threw TypeError on `registry.analyzeFile()` and never produced a
baseline — which is why fingerprints.json never existed in a usable
form after a fresh /understand, and is the root cause behind
issue #152's "every auto-update escalates to FULL_UPDATE" cascade.

Replace the LLM-written script with a bundled `build-fingerprints.mjs`
that mirrors `extract-structure.mjs`: resolves @understand-anything/core
via createRequire, initializes TreeSitterPlugin + PluginRegistry
correctly, calls buildFingerprintStore with all four arguments, and
persists via saveFingerprints. Smoke-tested on this repo (3 files,
correct functions/classes/imports extracted).

Reorder Phase 7 so fingerprints are written BEFORE meta.json. If
fingerprint generation fails, the new step explicitly says to abort
Phase 7 — meta.json must not advance without a valid baseline, or
the next auto-update sees a fresh commit hash with no fingerprints
and classifies every file as STRUCTURAL.

Affects every install since 2.7.0 (when the broken example was
introduced). Users running /understand --full on 2.7.3+ will get
a usable fingerprints.json on the first try.

Lum1104 · 2026-05-18 10:13:02 +08:00

e7af9ae35e

554 Commits