@liduchuan/atlas-loop 0.1.0 → 0.1.1

package/bin/atlas-loop.mjs

@@ -11,29 +11,31 @@ const PKG_ROOT = path.resolve(__dirname, '..');
 function readVersion() {
   try {
     const pkg = JSON.parse(fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
-    return pkg.version || '0.1.0';
+    return pkg.version || '0.1.1';
   } catch (_) {
-    return '0.1.0';
+    return '0.1.1';
   }
 }
 
 function printHelp() {
-  console.log(`@liduchuan/atlas-loop v${readVersion()}
+  console.log(`Atlas Loop (@liduchuan/atlas-loop v${readVersion()})
 
 Usage:
   npx @liduchuan/atlas-loop install [--dir <skills-dir>]
+  npx @liduchuan/atlas-loop dev [--port 5179] [--data <graph-data.json>]
   npx @liduchuan/atlas-loop build --data <graph-data.json> [--out <output.html>]
   npx @liduchuan/atlas-loop verify --html <output.html>
 
 Commands:
   install   Copy the atlas-loop skill into an Agent skills directory (default: ~/.agents/skills/atlas-loop)
+  dev       Launch the local live-reload runtime for template & style debugging
   build     Validate AtlasGraphData JSON and synthesize a standalone offline HTML learning map
   verify    Run headless Playwright verification against a generated HTML learning map
 `);
 }
 
 function copySkillFiles(destDir) {
-  const items = ['SKILL.md', 'assets', 'references', 'scripts'];
+  const items = ['SKILL.md', 'assets', 'references', 'scripts', 'template'];
   fs.mkdirSync(destDir, { recursive: true });
   for (const name of items) {
     const src = path.join(PKG_ROOT, name);
@@ -54,9 +56,9 @@ function resolveInstallDir(args) {
   return path.join(os.homedir(), '.agents', 'skills', 'atlas-loop');
 }
 
-function runScript(scriptName, forwardArgs) {
-  const scriptPath = path.join(PKG_ROOT, 'scripts', scriptName);
-  const res = spawnSync(process.execPath, [scriptPath, ...forwardArgs], { stdio: 'inherit' });
+function runNodeFile(relFilePath, forwardArgs) {
+  const fullPath = path.join(PKG_ROOT, relFilePath);
+  const res = spawnSync(process.execPath, [fullPath, ...forwardArgs], { stdio: 'inherit' });
   process.exit(res.status ?? 1);
 }
 
@@ -76,16 +78,20 @@ if (cmd === '-v' || cmd === '--version' || cmd === 'version') {
 if (cmd === 'install') {
   const dest = resolveInstallDir(argv.slice(1));
   copySkillFiles(dest);
-  console.log(`Installed atlas-loop skill to: ${dest}`);
+  console.log(`Installed Atlas Loop skill to: ${dest}`);
   process.exit(0);
 }
 
+if (cmd === 'dev') {
+  runNodeFile(path.join('template', 'dev-server.mjs'), argv.slice(1));
+}
+
 if (cmd === 'build') {
-  runScript('build_atlas.mjs', argv.slice(1));
+  runNodeFile(path.join('scripts', 'build_atlas.mjs'), argv.slice(1));
 }
 
 if (cmd === 'verify') {
-  runScript('verify_atlas.mjs', argv.slice(1));
+  runNodeFile(path.join('scripts', 'verify_atlas.mjs'), argv.slice(1));
 }
 
 console.error(`Unknown command: ${cmd}\n`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@liduchuan/atlas-loop",
-  "version": "0.1.0",
-  "description": "Universal recursive learning-map Agent Skill — dissect any unfamiliar subject into a standalone offline interactive HTML atlas with per-node deep-dive and recursive sub-atlas prompts.",
+  "version": "0.1.1",
+  "description": "Atlas Loop — Universal recursive learning-map Agent Skill that dissects any unfamiliar subject into a standalone offline interactive HTML atlas with per-node deep-dive and recursive sub-atlas prompts.",
   "type": "module",
   "license": "MIT",
   "author": "liduchuan",
@@ -16,12 +16,17 @@
   "bin": {
     "atlas-loop": "bin/atlas-loop.mjs"
   },
+  "scripts": {
+    "dev": "node template/dev-server.mjs",
+    "build:shell": "node template/build-shell.mjs"
+  },
   "files": [
     "SKILL.md",
     "README.md",
     "assets",
     "references",
     "scripts",
+    "template",
     "bin"
   ],
   "keywords": [
@@ -33,6 +38,13 @@
     "react-flow",
     "atlas-loop"
   ],
+  "devDependencies": {
+    "@dagrejs/dagre": "^1.1.8",
+    "@xyflow/react": "^12.12.1",
+    "esbuild": "^0.25.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1"
+  },
   "engines": {
     "node": ">=18.0.0"
   },

package/references/schema.md

@@ -1,4 +1,4 @@
-# AtlasLoop Graph Data Schema (`AtlasGraphData` v2)
+# Atlas Loop Graph Data Schema (`AtlasGraphData` v2)
 
 `scripts/build_atlas.mjs` consumes a UTF-8 JSON file matching this schema and injects it into `assets/viewer-shell.html` to produce a standalone, zero-CDN offline `.html` file.
 
@@ -32,10 +32,10 @@
         "askPrompts": [
           {
             "title": "Focused follow-up title",
-            "prompt": "Concrete, context-anchored deep-dive question (>= 20 chars)..."
+            "prompt": "Concrete, context-anchored deep-dive question (>= 20 chars)…"
           }
         ],
-        "subAtlasPrompt": "Prompt to recursively generate an L1+ sub-atlas for this stream..."
+        "subAtlasPrompt": "Use Atlas Loop to dissect \"<Stream Focus>\" in depth (L1+), with parentMapHtml set to \"<current-output.html>\"."
       }
     }
   ],
@@ -45,7 +45,7 @@
       "streamIds": ["stream-main"],
       "role": "entry",
       "title": "Node Title",
-      "summary": "Concise 1-2 sentence explanation shown on canvas card and inspector",
+      "summary": "Concise 1–2 sentence explanation shown on canvas card and inspector",
       "whyItMatters": "Why a learner must grasp this node",
       "keyFactors": {
         "inputs": "Preconditions, triggers, assumptions, or inputs",
@@ -77,10 +77,10 @@
         "askPrompts": [
           {
             "title": "Specific Inquiry Angle",
-            "prompt": "Detailed prompt referencing exact concepts, mechanisms, or file/chapter anchors..."
+            "prompt": "Detailed prompt referencing exact concepts, mechanisms, or file/chapter anchors…"
           }
         ],
-        "subAtlasPrompt": "Use atlas-loop to dissect \"<Node Focus>\" in depth (L1+), with parentMapHtml set to \"<current-output.html>\"."
+        "subAtlasPrompt": "Use Atlas Loop to dissect \"<Node Focus>\" in depth (L1+), with parentMapHtml set to \"<current-output.html>\"."
       }
     }
   ],
@@ -99,7 +99,7 @@
 
 1. **`meta.language` & `meta.uiLabels`**:
    - Built-in dictionaries automatically localize the UI for `zh*` and `en*`.
-   - When `meta.language` is another language (e.g. `ja`, `ko`, `es`, `fr`, `de`), populate `meta.uiLabels` with localized strings for keys (`modelPrefix`, `backParent`, `levelOverview`, `levelSubPrefix`, `allStreams`, `searchPlaceholder`, `zoomIn`, `zoomOut`, `lock`, `unlock`, `fitView`, `reset`, `legend`, `scopeNotes`, `learningPath`, `expandDetail`, `collapseDetail`, `detailEdgeLabel`, `deepDiveModalTitle`, `tabAsk`, `tabRecursive`, `copyBtn`, `copiedBtn`, `openInEditor`, `whatItDoes`, `whyItMatters`, `inputsLabel`, `outputsLabel`, `mechanismsLabel`, `watchoutsLabel`, `anchorsLabel`, `openDeepDiveBtn`, `unverifiedTag`, `verifiedTag`, `close`, and `roles`).
+   - When `meta.language` is another language (e.g. `ja`, `ko`, `es`, `fr`, `de`), populate `meta.uiLabels` with localized strings for keys (`skipToCanvas`, `modelPrefix`, `backParent`, `levelOverview`, `levelSubPrefix`, `allStreams`, `searchLabel`, `searchPlaceholder`, `zoomIn`, `zoomOut`, `lock`, `unlock`, `fitView`, `reset`, `legend`, `scopeNotes`, `learningPath`, `expandDetail`, `collapseDetail`, `detailEdgeLabel`, `deepDiveModalTitle`, `tabAsk`, `tabRecursive`, `copyBtn`, `copiedBtn`, `openInEditor`, `whatItDoes`, `whyItMatters`, `inputsLabel`, `outputsLabel`, `mechanismsLabel`, `watchoutsLabel`, `anchorsLabel`, `openDeepDiveBtn`, `unverifiedTag`, `verifiedTag`, `close`, and `roles`).
 2. **7 Universal Cognitive Roles (`node.role`)**:
    - `entry`: Starting point, user action, core question, or trigger.
    - `core`: Primary mechanism, processing step, or main argument.
@@ -110,13 +110,13 @@
    - `outcome`: Final result, takeaway, or target state.
 3. **Polymorphic `anchors` (Optional — Use What Fits the Subject)**:
    - Formula / CLI command / mental checklist / quote (`snippet`):
-     `{ "kind": "snippet", "label": "Key Formula / Command", "content": "..." }`
+     `{ "kind": "snippet", "label": "Key Formula / Command", "content": "…" }`
    - Web / documentation reference (`link`):
-     `{ "kind": "link", "label": "Official Guide", "url": "https://..." }`
+     `{ "kind": "link", "label": "Official Guide", "url": "https://…" }`
    - Book chapter / paper / factual citation (`source`):
-     `{ "kind": "source", "label": "Chapter 4, p.112", "citation": "..." }`
+     `{ "kind": "source", "label": "Chapter 4, p.112", "citation": "…" }`
    - Local file jump (`editor` — **only when verified local files exist on disk**):
      `{ "kind": "editor", "label": "Entry handler", "filePath": "src/app.ts", "absPath": "/abs/path/src/app.ts", "line": 42, "symbol": "runApp", "editor": "vscode" }`
-     (`build_atlas.mjs` verifies `absPath` and `line` exist on disk and computes the encoded `vscode://file/...` or `zed://file/...` URI automatically.)
+     (`build_atlas.mjs` verifies `absPath` and `line` exist on disk and computes the encoded `vscode://file/…` or `zed://file/…` URI automatically.)
 4. **Edge Labels**:
    - Every top-level edge MUST carry a non-empty `label` explaining the causal link, sequence, or branch condition.

package/scripts/build_atlas.mjs

@@ -237,7 +237,7 @@ function main() {
 
   const finalHtml = shellHtml
     .replace('__ATLAS_HTML_LANG__', escapeHtml(meta.language || 'en'))
-    .replace('__ATLAS_HTML_TITLE__', escapeHtml(`${meta.title} — AtlasLoop`))
+    .replace('__ATLAS_HTML_TITLE__', escapeHtml(`${meta.title} — Atlas Loop`))
     .replace('__ATLAS_DATA_JSON__', () => safeJsonPayload);
 
   fs.mkdirSync(path.dirname(outPath), { recursive: true });