archgraph 0.1.0 → 0.1.2

package/README.md

@@ -1,123 +1,107 @@
-# backend-graphing
+# archgraph
 
-Backend/frontend code graphing workspace for endpoint-oriented architecture visualization.
+Endpoint-first static code graph analyzer and interactive viewer for backend/frontend architectures.
+
+## Install
+
+```bash
+npm install -g archgraph
+```
 
 ## Packages
-- `@backend-graphing/core`: static analyzer, graph model, view builder, exporters
-- `@backend-graphing/cli`: `bgx` command for analyze/export/view/describe/install
-- `@backend-graphing/viewer`: local interactive viewer server + DAG client with code drilldown and task queue
+
+- `@archgraph/core`: static analyzer, graph model, view builder, exporters
+- `@archgraph/cli`: `arcgx` command for analyze/export/view/describe/install
+- `@archgraph/viewer`: local interactive viewer server + DAG client with code drilldown and task queue
 
 ## Quick Start
+
 ```bash
-# install globally from local repo
-npm install -g /Users/sangsoolee/GitHub/backend-graphing
-
-# analyze a backend repo
-node packages/cli/src/index.js analyze \
-  --project /Users/sangsoolee/GitHub/scout-manager-backend \
-  --out scout-manager-backend.graph.json
-
-# export to cypher
-node packages/cli/src/index.js export \
-  --graph scout-manager-backend.graph.json \
-  --format cypher \
-  --out scout-manager-backend.cypher
-
-# generate a filtered view file
-node packages/cli/src/index.js view \
-  --graph scout-manager-backend.graph.json \
-  --spec docs/examples/view-spec.yaml \
-  --out scout-manager-backend.view.json
-
-# launch local viewer
-node packages/cli/src/index.js view \
-  --graph scout-manager-backend.graph.json \
-  --serve \
-  --port 4310
-
-# generate structured bilingual descriptions
-node packages/cli/src/index.js describe \
-  --graph scout-manager-backend.graph.json \
-  --out scout-manager-backend.descriptions.json \
+# Analyze a backend repo
+arcgx analyze --project /path/to/your/project --out graph.json
+
+# Export to Cypher or Mermaid
+arcgx export --graph graph.json --format cypher --out graph.cypher
+arcgx export --graph graph.json --format mermaid --out graph.mmd
+
+# Generate a filtered view file
+arcgx view --graph graph.json --spec view-spec.yaml --out view.json
+
+# Launch interactive viewer
+arcgx view --graph graph.json --serve --port 4310
+
+# Generate structured bilingual descriptions
+arcgx describe \
+  --graph graph.json \
+  --out descriptions.json \
   --executor codex \
   --language bilingual \
   --detail structured
 ```
 
-After global install, use:
-```bash
-bgx --help
-bgx analyze --project /absolute/path/to/project --out graph.json
-```
-
 ## Install as Codex Skill / Claude Plugin
 
-Global install:
-```bash
-npm install -g /Users/sangsoolee/GitHub/backend-graphing
-```
-
-Automatic import into local assistant folders:
 ```bash
-# install both
-bgx install --target all
+# Install both Codex and Claude integrations
+arcgx install --target all
 
-# codex only
-bgx install --target codex
+# Codex only
+arcgx install --target codex
 
-# claude only
-bgx install --target claude
-```
+# Claude only
+arcgx install --target claude
 
-Custom home paths:
-```bash
-bgx install --target all --codex-home /path/to/.codex --claude-home /path/to/.claude
-```
+# Custom home paths
+arcgx install --target all --codex-home /path/to/.codex --claude-home /path/to/.claude
 
-Dry-run preview:
-```bash
-bgx install --target all --dry-run
+# Dry-run preview
+arcgx install --target all --dry-run
 ```
 
 ## Canonical Graph Format
+
 `GraphBundle { schemaVersion, createdAt, project, strings[], nodes[], edges[], groups[], indexes }`
 
 Node kinds:
+
 - `endpoint`, `route_handler`, `function`, `method`, `class`, `object`, `agent`, `langgraph_node`, `mcp_tool`, `module`, `file`, `ui_route`, `ui_component`, `group`, `condition`
 
 Edge kinds:
+
 - `declares_endpoint`, `handles`, `calls`, `imports`, `invokes_agent`, `uses_mcp_tool`, `langgraph_edge`, `belongs_to_group`, `ui_calls_api`, `frontend_proxies_to_backend`, `evaluates_condition`, `condition_true`, `condition_false`, `condition_case`
 
-## Current Extraction Coverage
-- Express route extraction from `app/router.METHOD` with mounted prefix propagation.
-- Handler linkage from endpoint to route handlers and function symbols.
-- Transitive call graph extraction using TypeScript AST (with local TypeScript module fallback).
-- Conditional flow extraction for `if`/`switch`/ternary branches into explicit condition nodes.
-- LangGraph extraction from `.addNode/.addEdge/.addConditionalEdges` chains.
-- MCP extraction from `*_TOOLS` arrays and `callTool("...")` usage.
-- Grouping by endpoint + secondary overlays by agent/purpose.
-
-## Viewer Capabilities (V2)
-- Endpoint-first directed graph rendering (logical DAG) with conditional edge styling.
-- Grouping by `endpoint`, `agent`, or `purpose` with item selector and search.
-- Node click opens code snippet and related 1-hop context.
-- Sidepanel comment/task queue with status lifecycle and approval-gated execution.
-- Optional descriptions panel source from `bgx describe` artifact.
+## Extraction Coverage
+
+- Express route extraction with mounted prefix propagation
+- Handler linkage from endpoint to route handlers and function symbols
+- Transitive call graph extraction using TypeScript AST (with local TypeScript module fallback)
+- Conditional flow extraction for `if`/`switch`/ternary branches into explicit condition nodes
+- LangGraph extraction from `.addNode/.addEdge/.addConditionalEdges` chains
+- MCP extraction from `*_TOOLS` arrays and `callTool("...")` usage
+- Grouping by endpoint + secondary overlays by agent/purpose
+
+## Viewer Capabilities
+
+- Endpoint-first directed graph rendering (logical DAG) with conditional edge styling
+- Grouping by `endpoint`, `agent`, or `purpose` with item selector and search
+- Node click opens code snippet and related 1-hop context
+- Sidepanel comment/task queue with status lifecycle and approval-gated execution
+- Optional descriptions panel from `arcgx describe` output
 
 Executor config template:
-- `docs/examples/executors.example.json` -> copy to `<target-repo>/.bgx/executors.json`
+
+- Copy `docs/examples/executors.example.json` to `<your-repo>/.arcgx/executors.json`
+
+## View Spec
+
+See [`docs/view-spec.md`](docs/view-spec.md) for the full view specification format.
 
 ## Tests
+
 ```bash
 npm test
 ```
 
-Test suites include:
-- extractor unit tests
-- view and export tests
-- integration checks against `/Users/sangsoolee/GitHub/scout-manager-backend`
-- CLI integration tests
-- viewer asset contract tests
+## License
 
-## PRD
-- `.omx/plans/prd-backend-graphing-engine.md`
+MIT

package/docs/release.md

@@ -6,9 +6,9 @@
 2. Verify tests:
    - `npm test`
 3. Publish packages in dependency order:
-   - `@backend-graphing/core`
-   - `@backend-graphing/viewer`
-   - `@backend-graphing/cli`
+   - `@archgraph/core`
+   - `@archgraph/viewer`
+   - `@archgraph/cli`
 
 ## Versioning
 - Follow semver.

package/docs/view-spec.md

@@ -1,6 +1,6 @@
 # View Spec
 
-`bgx view --spec <file>` accepts JSON or simple YAML.
+`arcgx view --spec <file>` accepts JSON or simple YAML.
 
 Supported fields:
 - `version`: required (`"1"`)
@@ -13,7 +13,7 @@ Supported fields:
 - `labelMode`: `short | full`
 
 Notes:
-- `depth` is still supported for `bgx view` artifact generation.
+- `depth` is still supported for `arcgx view` artifact generation.
 - Local viewer UI no longer exposes a depth slider; it renders from the generated view and group/search filters.
 
 Example:

package/integrations/README.md

@@ -3,18 +3,18 @@
 This folder contains copyable integration bundles for Codex and Claude.
 
 ## Codex
-- Source bundle: `integrations/codex/skills/backend-graphing/`
-- Source bundle: `integrations/codex/skills/backend-graphing-describe/`
-- Destination: `$CODEX_HOME/skills/backend-graphing/` (or `~/.codex/skills/backend-graphing/`)
+- Source bundle: `integrations/codex/skills/archgraph/`
+- Source bundle: `integrations/codex/skills/archgraph-describe/`
+- Destination: `$CODEX_HOME/skills/archgraph/` (or `~/.codex/skills/archgraph/`)
 
 ## Claude
 - Source bundle: `integrations/claude/`
-- Plugin destination: `~/.claude/plugins/marketplaces/backend-graphing/`
-- Skill destination: `~/.claude/skills/backend-graphing/`
-- Skill destination: `~/.claude/skills/backend-graphing-describe/`
+- Plugin destination: `~/.claude/plugins/marketplaces/archgraph/`
+- Skill destination: `~/.claude/skills/archgraph/`
+- Skill destination: `~/.claude/skills/archgraph-describe/`
 
 ## Automatic install
 Use:
 ```bash
-bgx install --target all
+arcgx install --target all
 ```

package/integrations/claude/{skills/backend-graphing → .claude/skills/archgraph}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing
-description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `bgx`, and export to Cypher/Mermaid or interactive view JSON.
+name: archgraph
+description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `arcgx`, and export to Cypher/Mermaid or interactive view JSON.
 ---
 
 # Backend Graphing Skill
@@ -17,32 +17,32 @@ description: Analyze backend/frontend codebases into endpoint-first graph artifa
 ## Commands
 1. Analyze project:
 ```bash
-bgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 2. Analyze with frontend linkage:
 ```bash
-bgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 3. Export Cypher:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
 ```
 
 4. Export Mermaid:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
 ```
 
 5. Build view JSON from spec:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
 ```
 
 6. Launch local viewer:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
+arcgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
 ```
 
 ## Output expectations

package/integrations/{codex/skills/backend-graphing-describe → claude/.claude/skills/archgraph-describe}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing-describe
-description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `bgx describe`.
+name: archgraph-describe
+description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `arcgx describe`.
 ---
 
 # Backend Graphing Describe Skill
@@ -10,14 +10,14 @@ description: Generate bilingual natural-language descriptions for endpoint/purpo
 - You want Korean + English architectural summaries for docs or reviews.
 
 ## Required input
-- Graph JSON path (`bgx analyze` output).
+- Graph JSON path (`arcgx analyze` output).
 - Output path for description bundle.
 - Executor choice (`codex` or `claude`).
 
 ## Commands
 1. Generate description bundle:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor codex \
@@ -27,16 +27,16 @@ bgx describe \
 
 2. Validate executor template config:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor claude \
-  --executor-config .bgx/executors.json
+  --executor-config .arcgx/executors.json
 ```
 
 3. Serve viewer with descriptions loaded:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
 ```
 
 ## Output expectations

package/integrations/claude/.claude-plugin/marketplace.json

@@ -1,13 +1,13 @@
 {
-  "name": "backend-graphing-marketplace",
-  "description": "Local marketplace metadata for backend-graphing plugin",
+  "name": "archgraph-marketplace",
+  "description": "Local marketplace metadata for archgraph plugin",
   "owner": {
     "name": "Sangsoo Lee"
   },
   "plugins": [
     {
-      "name": "backend-graphing",
-      "description": "Graph analysis plugin for endpoint-first backend/frontend architecture mapping with bgx",
+      "name": "archgraph",
+      "description": "Graph analysis plugin for endpoint-first backend/frontend architecture mapping with arcgx",
       "version": "0.1.0",
       "source": "./",
       "author": {

package/integrations/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
-  "name": "backend-graphing",
-  "description": "Graph analysis plugin for endpoint-first backend/frontend architecture mapping with bgx",
+  "name": "archgraph",
+  "description": "Graph analysis plugin for endpoint-first backend/frontend architecture mapping with arcgx",
   "version": "0.1.0",
   "author": {
     "name": "Sangsoo Lee"

package/integrations/{codex/skills/backend-graphing → claude/skills/archgraph}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing
-description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `bgx`, and export to Cypher/Mermaid or interactive view JSON.
+name: archgraph
+description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `arcgx`, and export to Cypher/Mermaid or interactive view JSON.
 ---
 
 # Backend Graphing Skill
@@ -17,32 +17,32 @@ description: Analyze backend/frontend codebases into endpoint-first graph artifa
 ## Commands
 1. Analyze project:
 ```bash
-bgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 2. Analyze with frontend linkage:
 ```bash
-bgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 3. Export Cypher:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
 ```
 
 4. Export Mermaid:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
 ```
 
 5. Build view JSON from spec:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
 ```
 
 6. Launch local viewer:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
+arcgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
 ```
 
 ## Output expectations

package/integrations/claude/{.claude/skills/backend-graphing-describe → skills/archgraph-describe}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing-describe
-description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `bgx describe`.
+name: archgraph-describe
+description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `arcgx describe`.
 ---
 
 # Backend Graphing Describe Skill
@@ -10,14 +10,14 @@ description: Generate bilingual natural-language descriptions for endpoint/purpo
 - You want Korean + English architectural summaries for docs or reviews.
 
 ## Required input
-- Graph JSON path (`bgx analyze` output).
+- Graph JSON path (`arcgx analyze` output).
 - Output path for description bundle.
 - Executor choice (`codex` or `claude`).
 
 ## Commands
 1. Generate description bundle:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor codex \
@@ -27,16 +27,16 @@ bgx describe \
 
 2. Validate executor template config:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor claude \
-  --executor-config .bgx/executors.json
+  --executor-config .arcgx/executors.json
 ```
 
 3. Serve viewer with descriptions loaded:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
 ```
 
 ## Output expectations

package/integrations/{claude/.claude/skills/backend-graphing → codex/skills/archgraph}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing
-description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `bgx`, and export to Cypher/Mermaid or interactive view JSON.
+name: archgraph
+description: Analyze backend/frontend codebases into endpoint-first graph artifacts with `arcgx`, and export to Cypher/Mermaid or interactive view JSON.
 ---
 
 # Backend Graphing Skill
@@ -17,32 +17,32 @@ description: Analyze backend/frontend codebases into endpoint-first graph artifa
 ## Commands
 1. Analyze project:
 ```bash
-bgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_PROJECT_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 2. Analyze with frontend linkage:
 ```bash
-bgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
+arcgx analyze --project <ABS_BACKEND_PATH> --frontend <ABS_FRONTEND_PATH> --out <GRAPH_JSON_PATH>
 ```
 
 3. Export Cypher:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format cypher --out <GRAPH_CYPHER_PATH>
 ```
 
 4. Export Mermaid:
 ```bash
-bgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
+arcgx export --graph <GRAPH_JSON_PATH> --format mermaid --out <GRAPH_MMD_PATH>
 ```
 
 5. Build view JSON from spec:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --spec <VIEW_SPEC_YAML_OR_JSON> --out <VIEW_JSON_PATH>
 ```
 
 6. Launch local viewer:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
+arcgx view --graph <GRAPH_JSON_PATH> --serve --port 4310
 ```
 
 ## Output expectations

package/integrations/{claude/skills/backend-graphing-describe → codex/skills/archgraph-describe}/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: backend-graphing-describe
-description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `bgx describe`.
+name: archgraph-describe
+description: Generate bilingual natural-language descriptions for endpoint/purpose graph nodes using `arcgx describe`.
 ---
 
 # Backend Graphing Describe Skill
@@ -10,14 +10,14 @@ description: Generate bilingual natural-language descriptions for endpoint/purpo
 - You want Korean + English architectural summaries for docs or reviews.
 
 ## Required input
-- Graph JSON path (`bgx analyze` output).
+- Graph JSON path (`arcgx analyze` output).
 - Output path for description bundle.
 - Executor choice (`codex` or `claude`).
 
 ## Commands
 1. Generate description bundle:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor codex \
@@ -27,16 +27,16 @@ bgx describe \
 
 2. Validate executor template config:
 ```bash
-bgx describe \
+arcgx describe \
   --graph <GRAPH_JSON_PATH> \
   --out <DESCRIPTION_JSON_PATH> \
   --executor claude \
-  --executor-config .bgx/executors.json
+  --executor-config .arcgx/executors.json
 ```
 
 3. Serve viewer with descriptions loaded:
 ```bash
-bgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
+arcgx view --graph <GRAPH_JSON_PATH> --serve --descriptions <DESCRIPTION_JSON_PATH>
 ```
 
 ## Output expectations

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "archgraph",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Endpoint-first static code graph analyzer and interactive viewer for backend/frontend architectures",
   "type": "module",
   "bin": {
-    "bgx": "./bin/bgx.js"
+    "arcgx": "./bin/arcgx.js"
   },
   "files": [
     "bin",
@@ -45,5 +45,8 @@
   "homepage": "https://github.com/Lee-Sangsu/backend-graphing#readme",
   "engines": {
     "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
   }
-}
+}

package/packages/cli/src/index.js

@@ -14,8 +14,8 @@ async function loadWorkspaceModule(name, fallbackPath) {
   }
 }
 
-const coreModule = await loadWorkspaceModule('@backend-graphing/core', '../../core/src/index.js');
-const viewerModule = await loadWorkspaceModule('@backend-graphing/viewer', '../../viewer/src/index.js');
+const coreModule = await loadWorkspaceModule('@archgraph/core', '../../core/src/index.js');
+const viewerModule = await loadWorkspaceModule('@archgraph/viewer', '../../viewer/src/index.js');
 
 const { analyzeProject, buildView, exportGraph } = coreModule;
 const { startViewerServer } = viewerModule;
@@ -25,11 +25,11 @@ const PROJECT_ROOT = resolve(dirname(CLI_FILE), '../../../');
 function usage() {
   return [
     'Usage:',
-    '  bgx analyze --project <path> --out <file> [--format graph-json] [--compress gzip]',
-    '  bgx export --graph <file> --format cypher|mermaid --out <file>',
-    '  bgx view --graph <file> [--spec <view.yaml|json>] [--serve] [--port 4310]',
-    '  bgx describe --graph <file> --out <file> --executor codex|claude [--executor-config <path>] [--language bilingual] [--detail structured]',
-    '  bgx install [--target codex|claude|all] [--codex-home <dir>] [--claude-home <dir>] [--dry-run]',
+    '  arcgx analyze --project <path> --out <file> [--format graph-json] [--compress gzip]',
+    '  arcgx export --graph <file> --format cypher|mermaid --out <file>',
+    '  arcgx view --graph <file> [--spec <view.yaml|json>] [--serve] [--port 4310]',
+    '  arcgx describe --graph <file> --out <file> --executor codex|claude [--executor-config <path>] [--language bilingual] [--detail structured]',
+    '  arcgx install [--target codex|claude|all] [--codex-home <dir>] [--claude-home <dir>] [--dry-run]',
   ].join('\n');
 }
 
@@ -177,7 +177,7 @@ function buildDescriptionBundle(graph, { executor, language = 'bilingual', detai
 }
 
 async function installCodexSkill({ codexHome, dryRun }) {
-  const skillNames = ['backend-graphing', 'backend-graphing-describe'];
+  const skillNames = ['archgraph', 'archgraph-describe'];
   const installs = [];
 
   for (const name of skillNames) {
@@ -203,8 +203,8 @@ async function installCodexSkill({ codexHome, dryRun }) {
 
 async function installClaudePlugin({ claudeHome, dryRun }) {
   const pluginSource = join(PROJECT_ROOT, 'integrations', 'claude');
-  const pluginDestination = join(claudeHome, 'plugins', 'marketplaces', 'backend-graphing');
-  const skillNames = ['backend-graphing', 'backend-graphing-describe'];
+  const pluginDestination = join(claudeHome, 'plugins', 'marketplaces', 'archgraph');
+  const skillNames = ['archgraph', 'archgraph-describe'];
 
   if (!(await pathExists(pluginSource))) {
     throw new Error(`Claude plugin source not found: ${pluginSource}`);

package/packages/core/src/export.js

@@ -10,7 +10,7 @@ function escapeMermaid(value) {
 
 function toCypher(graph) {
   const lines = [];
-  lines.push('// backend-graphing cypher export');
+  lines.push('// archgraph cypher export');
   lines.push('BEGIN;');
 
   const nodes = [...graph.nodes].sort((a, b) => a.id.localeCompare(b.id));

package/packages/viewer/public/app.js

@@ -1,4 +1,4 @@
-// app.js — BGX Viewer entry point
+// app.js — ARCGX Viewer entry point
 
 import { initCanvas, canvasTransform, nodePositions, applyCanvasTransform } from './canvas.js';
 import { initMinimap, setMinimapView, updateMinimap } from './minimap.js';
@@ -147,8 +147,8 @@ async function loadData() {
   view = await viewRes.json();
   descriptions = await descRes.json();
 
-  projectNameEl.textContent = graph.project?.name ?? 'BGX Viewer';
-  document.title = `BGX — ${graph.project?.name ?? 'Viewer'}`;
+  projectNameEl.textContent = graph.project?.name ?? 'ARCGX Viewer';
+  document.title = `ARCGX — ${graph.project?.name ?? 'Viewer'}`;
 
   setRenderView(view);
   setMinimapView(view);
@@ -170,14 +170,14 @@ function doResetView() {
 }
 
 // ─── Global hooks (used by render.js and minimap.js to avoid circular deps) ───
-window.__bgxPanToWorld = (worldX, worldY) => {
+window.__arcgxPanToWorld = (worldX, worldY) => {
   const rect = graphSvg.getBoundingClientRect();
   canvasTransform.x = rect.width / 2 - worldX * canvasTransform.scale;
   canvasTransform.y = rect.height / 2 - worldY * canvasTransform.scale;
   applyCanvasTransform();
 };
 
-window.__bgxRender = async () => {
+window.__arcgxRender = async () => {
   await render();
 };
 

package/packages/viewer/public/canvas.js

@@ -118,8 +118,8 @@ function onCanvasPointerMove(e) {
         y: dragStart.ny + dy,
       });
       // repositionNodeAndEdges is imported dynamically to avoid circular deps
-      if (window.__bgxRepositionNode) {
-        window.__bgxRepositionNode(draggingNodeId);
+      if (window.__arcgxRepositionNode) {
+        window.__arcgxRepositionNode(draggingNodeId);
       }
     }
     return;

package/packages/viewer/public/index.html

@@ -3,7 +3,7 @@
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>BGX Viewer</title>
+    <title>ARCGX Viewer</title>
     <link rel="stylesheet" href="/styles.css" />
   </head>
   <body>
@@ -17,7 +17,7 @@
 
     <!-- Layer 2: Floating toolbar (Figma-style top bar) -->
     <div id="toolbar">
-      <span id="projectName" class="toolbar-title">BGX Viewer</span>
+      <span id="projectName" class="toolbar-title">ARCGX Viewer</span>
 
       <div id="toolbarControls">
         <label class="ctrl-label">
@@ -82,7 +82,10 @@
       </div>
     </div>
 
-    <!-- Layer 5: Minimap -->
+    <!-- Layer 5: Tasks panel -->
+    <aside id="tasksPanel" class="tasks-panel" aria-hidden="true"></aside>
+
+    <!-- Layer 6: Minimap -->
     <div id="minimap">
       <svg id="minimapSvg" xmlns="http://www.w3.org/2000/svg"></svg>
     </div>

package/packages/viewer/public/minimap.js

@@ -86,7 +86,7 @@ function onMinimapClick(e) {
   const worldY = mmY / mmScale + minY;
 
   // Import canvasTransform at runtime to avoid circular dep — use global reference
-  if (window.__bgxPanToWorld) {
-    window.__bgxPanToWorld(worldX, worldY);
+  if (window.__arcgxPanToWorld) {
+    window.__arcgxPanToWorld(worldX, worldY);
   }
 }

package/packages/viewer/public/render.js

@@ -237,7 +237,7 @@ export function renderGraph(nodes, edges) {
         } else {
           collapsedGroups.add(groupId);
         }
-        if (window.__bgxRender) window.__bgxRender();
+        if (window.__arcgxRender) window.__arcgxRender();
       });
 
       group.appendChild(toggle);
@@ -258,7 +258,7 @@ export function renderGraph(nodes, edges) {
   }
 
   // Register repositionNodeAndEdges globally for canvas.js to call
-  window.__bgxRepositionNode = (nodeId) => repositionNodeAndEdges(nodeId);
+  window.__arcgxRepositionNode = (nodeId) => repositionNodeAndEdges(nodeId);
 }
 
 export function renderCommentPins(tasks) {

package/packages/viewer/public/styles.css

@@ -1,5 +1,5 @@
 /* ──────────────────────────────────────────────────────────────────
-   BGX Viewer — Figma-like canvas layout
+   ARCGX Viewer — Figma-like canvas layout
    ────────────────────────────────────────────────────────────────── */
 
 /* ─── Design tokens (light mode) ─────────────────────────────────── */

package/packages/viewer/public/theme.js

@@ -1,6 +1,6 @@
 // theme.js — Dark / light mode toggle
 
-const STORAGE_KEY = 'bgx-theme';
+const STORAGE_KEY = 'arcgx-theme';
 
 export function initTheme() {
   const saved = localStorage.getItem(STORAGE_KEY) ?? 'light';

package/packages/viewer/src/index.js

@@ -134,8 +134,8 @@ export async function createViewerService(options) {
   const graph = options.graph;
   const view = options.view ?? { spec: { version: '1' }, nodes: graph.nodes, edges: graph.edges, groups: graph.groups };
   const repoRoot = resolve(options.repoRoot ?? graph?.project?.rootPath ?? process.cwd());
-  const tasksFile = options.tasksFile ?? join(repoRoot, '.bgx', 'comment-tasks.json');
-  const executorConfigPath = options.executorConfigPath ?? join(repoRoot, '.bgx', 'executors.json');
+  const tasksFile = options.tasksFile ?? join(repoRoot, '.arcgx', 'comment-tasks.json');
+  const executorConfigPath = options.executorConfigPath ?? join(repoRoot, '.arcgx', 'executors.json');
   const descriptionsPath = options.descriptionsPath ?? null;
 
   const nodeById = new Map(graph.nodes.map((node) => [node.id, node]));