layerweave 0.0.0-stage → 0.7.9-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LayerWeave contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,35 @@
+# LayerWeave npm launcher
+
+[简体中文](https://github.com/aceddad/LayerWeave/blob/v0.7.9b1/distribution/npm/README.md) | English
+
+Start LayerWeave with one command on Windows x64. This package prepares the runtime and forwards arguments. All example, project, view, and MCP behavior lives in the same Python application used by uv.
+
+## Quick start
+
+Run from your chosen working directory:
+
+```powershell
+npx --yes layerweave@0.7.9-beta.1 demo
+```
+
+This npm preview uses the next dist-tag and pins Python package `0.7.9b1`. It supports Windows x64 and Node.js 20+. Python and uv do not need to be installed beforehand.
+
+## Commands
+
+- `demo`: prepare and open article reading in `./layerweave-demo/article-reading`.
+- `demo --list`: list examples; other examples download on demand.
+- `demo comic-creation --dir ./my-comic`: prepare another example at a chosen location.
+- `view ./project.sqlite3` or `view ./my-comic`: open an existing database or launcher project.
+- `new ./my-project --template subtitles`: create a project from a template.
+- `help project_overview`: reuse the existing detailed tool help.
+- `mcp --config ./mcp.json`: run MCP; the npm launcher requests the matching mcp extra.
+
+Reopening preserves edits. The server runs in the foreground; Ctrl+C stops it without deleting project data. Use `--no-browser` to print the URL only, or `--port` to choose a port. Environment setup messages go to stderr, leaving MCP stdout for its protocol.
+
+## Runtime and maintenance
+
+The launcher reuses uv >= 0.9 from PATH when available. Otherwise it downloads a pinned official uv archive, verifies SHA-256, and extracts it into the user's cache. uv prepares an independent Python 3.11 and application environment without changing PATH or shell configuration. First use needs internet access; later runs reuse caches.
+
+The default cache is `%LOCALAPPDATA%/LayerWeave/cache`. LAYERWEAVE_CACHE_DIR changes its location; LAYERWEAVE_UV selects an existing executable; LAYERWEAVE_PYTHON_PACKAGE selects a local wheel or full Python requirement for unpublished-package testing. Custom sources should match the npm package's Python version and include the mcp extra when needed.
+
+Run `npm test` to verify and `npm pack` to build. Only the launcher is shipped: no user data, install-time scripts, or duplicate Python implementation. Registry publication requires the maintainer's accounts and authorization.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# LayerWeave npm 启动器
+
+简体中文 | [English](https://github.com/aceddad/LayerWeave/blob/v0.7.9b1/distribution/npm/README.en.md)
+
+在 Windows x64 上，以一条命令启动 LayerWeave。npm 包只准备运行环境并转交参数，案例、数据库、视图与 MCP 的业务逻辑全部来自同一份 Python 包。
+
+## 快速开始
+
+在自己的工作目录中执行：
+
+```powershell
+npx --yes layerweave@0.7.9-beta.1 demo
+```
+
+本次 npm 预览版使用 next 通道，固定匹配 Python `0.7.9b1`。支持 Windows x64、Node.js 20+；不需要预先安装 Python 或 uv。
+
+## 命令
+
+- `demo`：准备并打开文章解析，默认保存到 `./layerweave-demo/article-reading`。
+- `demo --list`：列出全部案例；其他案例按需下载。
+- `demo comic-creation --dir ./my-comic`：在指定目录体验漫画案例。
+- `view ./project.sqlite3` 或 `view ./my-comic`：打开已有内容。
+- `new ./my-project --template subtitles`：创建自己的模板项目。
+- `help project_overview`：查看现有详细 help。
+- `mcp --config ./mcp.json`：启动 MCP；启动器自动选用对应版本的 mcp extra。
+
+项目重复打开时保留修改。服务在前台运行，Ctrl+C 停止服务。`--no-browser` 只打印地址，`--port` 可指定端口。MCP 的 stdout 保留给协议，环境准备提示写到 stderr。
+
+## 环境与维护
+
+优先使用 PATH 中可用的 uv >= 0.9；没有时下载固定版本的官方 uv，核对 SHA-256 后解压到用户缓存。uv 自动准备独立的 Python 3.11 与 LayerWeave 环境，不修改 PATH 或 shell 配置。首次准备需要网络，后续可复用缓存。源码在 lib/launch.mjs，官方 uv 地址与校验值在 runtime.json。
+
+默认缓存为 `%LOCALAPPDATA%/LayerWeave/cache`。LAYERWEAVE_CACHE_DIR 可改缓存位置；LAYERWEAVE_UV 可指定已有 uv；LAYERWEAVE_PYTHON_PACKAGE 可指定本地 wheel 或完整 Python requirement，供未发布包验证。自定义来源时请使用与 npm 版本相符的 Python 包；需要 MCP 时提供含 mcp extra 的 requirement。
+
+构建 npm 包执行 `npm pack`；验证执行 `npm test`。包中没有项目数据库、用户素材、安装后脚本或另一份 Python 实现。发布需要维护者账号与授权，详见仓库发布说明。

package/bin/layerweave.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { main } from '../lib/launch.mjs';
+
+try {
+  process.exitCode = await main(process.argv.slice(2));
+} catch (error) {
+  console.error(`LayerWeave: ${error.message}`);
+  process.exitCode = 1;
+}

package/lib/launch.mjs

@@ -0,0 +1,132 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { access, mkdir, mkdtemp, readFile, rename, rm } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+
+const metadata = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+const runtime = JSON.parse(await readFile(new URL('../runtime.json', import.meta.url), 'utf8'));
+
+export function cacheRoot(env = process.env) {
+  return path.resolve(env.LAYERWEAVE_CACHE_DIR || path.join(env.LOCALAPPDATA || path.join(homedir(), 'AppData', 'Local'), 'LayerWeave', 'cache'));
+}
+
+async function exists(file) {
+  try { await access(file); return true; } catch { return false; }
+}
+
+export async function download(url, output, sha256) {
+  if (process.platform === 'win32' && url.startsWith('https:')) {
+    // Use the Windows proxy and certificate settings; do not disable TLS checks.
+    const powershell = path.join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    await new Promise((resolve, reject) => {
+      const child = spawn(powershell, ['-NoProfile', '-NonInteractive', '-Command',
+        "$ErrorActionPreference='Stop'; $ProgressPreference='SilentlyContinue'; [Console]::OutputEncoding=[Text.UTF8Encoding]::new(); Invoke-WebRequest -UseBasicParsing -TimeoutSec 120 -Uri $env:LAYERWEAVE_UV_URL -OutFile $env:LAYERWEAVE_UV_OUTPUT"],
+      { env: { ...process.env, LAYERWEAVE_UV_URL: url, LAYERWEAVE_UV_OUTPUT: output }, stdio: ['ignore', 'ignore', 'pipe'], windowsHide: true });
+      let error = '';
+      child.stderr.setEncoding('utf8');
+      child.stderr.on('data', chunk => { error += chunk; });
+      child.once('error', reject);
+      child.once('close', code => code === 0 ? resolve() : reject(new Error(`uv download failed: ${error.trim()}`)));
+    });
+  } else {
+    const response = await fetch(url, { signal: AbortSignal.timeout(120_000) });
+    if (!response.ok) throw new Error(`Download failed: HTTP ${response.status} (${url})`);
+    await pipeline(Readable.fromWeb(response.body), createWriteStream(output));
+  }
+  const hash = createHash('sha256');
+  for await (const chunk of createReadStream(output)) hash.update(chunk);
+  if (hash.digest('hex') !== sha256) throw new Error('uv archive checksum mismatch; retry the command.');
+}
+
+function usableUv(command) {
+  const result = spawnSync(command, ['--version'], { encoding: 'utf8', windowsHide: true, timeout: 10_000 });
+  const version = /^uv (\d+)\.(\d+)\./.exec(result.stdout || '');
+  return result.status === 0 && version && (Number(version[1]) > 0 || Number(version[2]) >= 9);
+}
+
+export async function prepareUv(env = process.env) {
+  if (env.LAYERWEAVE_UV) {
+    if (!usableUv(env.LAYERWEAVE_UV)) throw new Error('LAYERWEAVE_UV must point to uv >= 0.9.');
+    return env.LAYERWEAVE_UV;
+  }
+  if (usableUv('uv')) return 'uv';
+  const spec = runtime.targets[`${process.platform}-${process.arch}`];
+  if (!spec) throw new Error('This npm preview supports Windows x64. Use the Python/uv distribution on other platforms.');
+  const parent = path.join(cacheRoot(env), 'runtime');
+  const directory = path.join(parent, `uv-${runtime.version}`);
+  const executable = path.join(directory, 'uv.exe');
+  if (await exists(executable)) return executable;
+  await mkdir(parent, { recursive: true });
+  const staging = await mkdtemp(path.join(parent, '.uv-'));
+  try {
+    console.error(`LayerWeave: preparing uv ${runtime.version} in ${directory}`);
+    const archive = path.join(staging, 'uv.zip');
+    await download(spec.url, archive, spec.sha256);
+    const extracted = path.join(staging, 'unpacked');
+    const powershell = path.join(env.SystemRoot || 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    const result = spawnSync(powershell, ['-NoProfile', '-NonInteractive', '-Command',
+      "$ErrorActionPreference='Stop'; Expand-Archive -LiteralPath $env:LAYERWEAVE_UV_ARCHIVE -DestinationPath $env:LAYERWEAVE_UV_EXTRACT"],
+    { env: { ...env, LAYERWEAVE_UV_ARCHIVE: archive, LAYERWEAVE_UV_EXTRACT: extracted }, encoding: 'utf8', windowsHide: true });
+    if (result.status !== 0) throw new Error(`Cannot extract uv: ${result.stderr || result.error?.message}`);
+    if (!(await exists(path.join(extracted, 'uv.exe')))) throw new Error('Downloaded uv archive is missing uv.exe.');
+    try { await rename(extracted, directory); }
+    catch (error) { if (!(await exists(executable))) throw error; }
+    return executable;
+  } finally {
+    // Only remove the unique staging directory created by this invocation.
+    await rm(staging, { recursive: true, force: true });
+  }
+}
+
+export function commandArgs(argv, env = process.env) {
+  const extra = argv[0] === 'mcp' ? '[mcp]' : '';
+  const requirement = env.LAYERWEAVE_PYTHON_PACKAGE || `layerweave${extra}==${metadata.layerweave.pythonVersion}`;
+  return ['tool', 'run', '--no-config', '--managed-python', '--python', '3.11', '--from', requirement, 'layerweave', ...argv];
+}
+
+export function forward(command, args, env = process.env) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, { env, stdio: 'inherit', windowsHide: true });
+    let stopping;
+    let timer;
+    const handlers = new Map();
+    const cleanup = () => {
+      clearTimeout(timer);
+      for (const [signal, handler] of handlers) process.removeListener(signal, handler);
+    };
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+      const handler = () => {
+        if (stopping) return;
+        stopping = signal;
+        if (process.platform !== 'win32') child.kill(signal);
+        // Windows console Ctrl+C reaches uv and Python too. Allow their normal
+        // shutdown first; terminate only this child tree if it does not exit.
+        timer = setTimeout(() => {
+          if (process.platform === 'win32' && child.pid) {
+            spawn('taskkill', ['/PID', String(child.pid), '/T', '/F'], { stdio: 'ignore', windowsHide: true });
+          } else child.kill('SIGKILL');
+        }, 5000).unref();
+      };
+      handlers.set(signal, handler);
+      process.on(signal, handler);
+    }
+    child.once('error', error => { cleanup(); reject(error); });
+    child.once('close', (code, signal) => {
+      cleanup();
+      resolve(stopping === 'SIGINT' ? 130 : stopping === 'SIGTERM' ? 143 : code ?? (signal ? 1 : 0));
+    });
+  });
+}
+
+export async function main(argv) {
+  const uv = await prepareUv();
+  const root = cacheRoot();
+  const env = { ...process.env, PYTHONUTF8: '1',
+    UV_CACHE_DIR: process.env.UV_CACHE_DIR || path.join(root, 'uv'),
+    UV_PYTHON_INSTALL_DIR: process.env.UV_PYTHON_INSTALL_DIR || path.join(root, 'python') };
+  return forward(uv, commandArgs(argv), env);
+}

package/package.json

@@ -1,6 +1,15 @@
-{
-  "name": "layerweave",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+{
+  "name": "layerweave",
+  "version": "0.7.9-beta.1",
+  "description": "One-command LayerWeave examples, projects and MCP with an automatically managed Python environment",
+  "type": "module",
+  "bin": {"layerweave": "bin/layerweave.mjs"},
+  "files": ["bin", "lib", "runtime.json", "README.md", "README.en.md", "LICENSE"],
+  "engines": {"node": ">=20"},
+  "os": ["win32"],
+  "cpu": ["x64"],
+  "scripts": {"test": "node --test test/*.test.mjs"},
+  "license": "MIT",
+  "repository": {"type": "git", "url": "git+https://github.com/aceddad/LayerWeave.git", "directory": "distribution/npm"},
+  "layerweave": {"pythonVersion": "0.7.9b1"}
+}

package/runtime.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.13.4",
+  "targets": {
+    "win32-x64": {
+      "url": "https://github.com/astral-sh/uv/releases/download/0.13.4/uv-x86_64-pc-windows-msvc.zip",
+      "sha256": "ccec7508a07d9933d7cb1261880633efcf1f30d6e6eddab21823f1dae6f23225"
+    }
+  }
+}