@laitszkin/apollo-toolkit 3.11.1 → 3.11.2

package/CHANGELOG.md

@@ -10,6 +10,18 @@ All notable changes to this repository are documented in this file.
 
 ### Fixed
 
+## [v3.11.2] - 2026-05-11
+
+### Fixed
+
+- `apltk architecture` / `resolveProjectRoot`: auto-create `resources/project-architecture/` on every command; when no atlas marker is found walking parent directories, use the current working directory as the project root (explicit `--project` still wins). `open` renders a fresh `index.html` when the file is missing so an empty tree bootstraps in one step.
+- Legacy `init-project-html/scripts/architecture.js` `open` / `diff`: same directory creation and one-shot `render` bootstrap via `architecture-bootstrap-render.js` when `index.html` is absent.
+
+### Added
+
+- `init-project-html/scripts/architecture-bootstrap-render.js` helper invoked by the legacy sync `open` path.
+- Tests: `test/atlas-cli.test.js` covers `--project` on a bare directory (layout + `index.html`); `test/architecture-script.test.js` expects legacy `open` to exit 0 when `index.html` is missing after bootstrap.
+
 ## [v3.11.1] - 2026-05-11
 
 ### Added

package/init-project-html/lib/atlas/cli.js

@@ -22,7 +22,7 @@
 //   help / --help / -h                            usage
 //
 // Global flags:
-//   --project <root>     project root (default: nearest ancestor with resources/project-architecture/)
+//   --project <root>     project root; creates resources/project-architecture/ if missing
 //   --spec <spec_dir>    spec directory; mutations go to <spec_dir>/architecture_diff/atlas/
 //   --no-render          skip auto-render after a mutation
 //   --no-open            for open/diff: skip launching the browser
@@ -67,7 +67,7 @@ Verbs:
   help                                  show this help
 
 Global flags:
-  --project <root>                      project root (default: nearest ancestor with resources/project-architecture/)
+  --project <root>                      explicit project root (default: nearest ancestor with atlas markers, else cwd); missing directories under resources/project-architecture/ are created automatically
   --spec <spec_dir>                     mutations write to <spec_dir>/architecture_diff/atlas/
   --no-render                           skip auto-render after a mutation
   --no-open                             for open/diff: skip launching the browser
@@ -98,6 +98,10 @@ function openInBrowser(filePath) {
   } catch (_e) { /* best effort */ }
 }
 
+function ensureResourcesLayout(projectRoot) {
+  fs.mkdirSync(path.join(projectRoot, ATLAS_REL), { recursive: true });
+}
+
 function findProjectRoot(startDir) {
   let dir = path.resolve(startDir);
   while (true) {
@@ -154,10 +158,15 @@ function requireFlag(flags, name) {
 }
 
 function resolveProjectRoot(flags) {
-  if (flags.project) return path.resolve(String(flags.project));
-  const root = findProjectRoot(process.cwd());
-  if (!root) throw new Error('Could not find resources/project-architecture/. Pass --project <root> or run inside the project.');
-  return root;
+  const finish = (root) => {
+    ensureResourcesLayout(root);
+    return root;
+  };
+  if (flags.project) return finish(path.resolve(String(flags.project)));
+  const discovered = findProjectRoot(process.cwd());
+  if (discovered) return finish(discovered);
+  // No marker walking parents — use cwd and create resources/project-architecture/.
+  return finish(process.cwd());
 }
 
 function specOverlayDir(projectRoot, specFlag) {
@@ -655,14 +664,10 @@ async function verbUndo(flags, projectRoot, io) {
 async function verbOpen(flags, projectRoot, io) {
   const atlas = path.join(projectRoot, ATLAS_INDEX_REL);
   if (!fs.existsSync(atlas)) {
-    // Try to render fresh if state exists
-    const baseDir = baseAtlasDir(projectRoot);
-    if (fs.existsSync(path.join(baseDir, stateLib.INDEX_FILE))) {
-      await runRender({ projectRoot, flags: { ...flags, spec: undefined } });
-    }
+    await runRender({ projectRoot, flags: { ...flags, spec: undefined } });
   }
   if (!fs.existsSync(atlas)) {
-    io.stderr.write(`Atlas not found: ${atlas}\n`);
+    io.stderr.write(`Atlas not found after render: ${atlas}\n`);
     return 1;
   }
   io.stdout.write(`${atlas}\n`);

package/init-project-html/scripts/architecture-bootstrap-render.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+'use strict';
+
+// One-shot helper: `node architecture-bootstrap-render.js render --project <root> ...`
+// Invoked synchronously from architecture.js (legacy open) when index.html is missing
+// so the sync `main()` can still bootstrap an empty tree without duplicating elk layout.
+
+const cli = require('../lib/atlas/cli');
+
+(async () => {
+  const code = await cli.dispatch(process.argv.slice(2));
+  process.exit(typeof code === 'number' ? code : 1);
+})().catch((err) => {
+  process.stderr.write(`${err && err.stack ? err.stack : err}\n`);
+  process.exit(1);
+});

package/init-project-html/scripts/architecture.js

@@ -15,7 +15,7 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { spawn } = require('node:child_process');
+const { spawn, spawnSync } = require('node:child_process');
 
 const newCli = require('../lib/atlas/cli');
 
@@ -47,7 +47,7 @@ Usage:
   apltk architecture --help                   Show this help
 
 Global flags:
-  --project <root>   Project root (default: nearest ancestor with resources/project-architecture/)
+  --project <root>   Project root (default: nearest ancestor with resources/project-architecture/, else cwd); missing layout dirs are created when needed
   --spec <spec_dir>  Mutations write to <spec_dir>/architecture_diff/atlas/
   --no-render        Skip auto-render after a mutation
   --no-open          For open/diff: skip launching the browser
@@ -221,14 +221,24 @@ function renderViewer({ changes, projectRoot, outDir }) {
 }
 
 function runOpen(opts, io) {
-  const projectRoot = opts.projectRoot || findProjectRoot(process.cwd());
+  let projectRoot = opts.projectRoot
+    ? path.resolve(opts.projectRoot)
+    : findProjectRoot(process.cwd());
   if (!projectRoot) {
-    io.stderr.write(
-      `Could not find resources/project-architecture/index.html. Pass --project <root> or generate the atlas via the init-project-html skill.\n`,
-    );
-    return 1;
+    projectRoot = process.cwd();
   }
+  fs.mkdirSync(path.join(projectRoot, RESOURCES_REL), { recursive: true });
   const atlas = path.join(projectRoot, ATLAS_REL);
+  if (!fs.existsSync(atlas)) {
+    const bootstrap = path.join(__dirname, 'architecture-bootstrap-render.js');
+    const result = spawnSync(process.execPath, [bootstrap, 'render', '--project', projectRoot, '--no-open'], {
+      stdio: 'ignore',
+    });
+    if (result.status !== 0) {
+      io.stderr.write(`Atlas not found and render failed: ${atlas}\n`);
+      return 1;
+    }
+  }
   if (!fs.existsSync(atlas)) {
     io.stderr.write(`Atlas not found: ${atlas}\n`);
     return 1;
@@ -239,13 +249,13 @@ function runOpen(opts, io) {
 }
 
 function runDiff(opts, io) {
-  const projectRoot = opts.projectRoot || findProjectRoot(process.cwd());
+  let projectRoot = opts.projectRoot
+    ? path.resolve(opts.projectRoot)
+    : findProjectRoot(process.cwd());
   if (!projectRoot) {
-    io.stderr.write(
-      `Could not find resources/project-architecture/index.html. Pass --project <root> or generate the atlas via the init-project-html skill.\n`,
-    );
-    return 1;
+    projectRoot = process.cwd();
   }
+  fs.mkdirSync(path.join(projectRoot, RESOURCES_REL), { recursive: true });
   const outDir = opts.out || path.join(projectRoot, DEFAULT_OUT_REL);
   fs.mkdirSync(outDir, { recursive: true });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@laitszkin/apollo-toolkit",
-  "version": "3.11.1",
+  "version": "3.11.2",
   "description": "Apollo Toolkit npm installer for managed skill copying across Codex, OpenClaw, and Trae.",
   "license": "MIT",
   "author": "LaiTszKin",