@askewly/design 0.7.0 → 1.0.0

package/README.md

@@ -20,7 +20,7 @@ npx @askewly/design verify src
 | `recipes list` / `recipes show <id>` | Agent-ready implementation contracts (200+ recipes). |
 | `knowledge list` / `search <query>` / `show <id>` | Design knowledge rules: decision tables and judgment gates. |
 | `assets search <query>` / `assets show <id>` | One md per asset (registry + recipes): definition, usage rules, install command. Bundled, works offline. `show` on an unknown id exits `1` with 3 closest ids (0.6.0). |
-| `site list` / `site get <slug> [dir]` | Download a reproduced-site bundle: structure only (code, layout, motion, text). Images are same-size blank placeholders; video, audio and fonts are left out (originals stay with their owners). Verifies sha256, refuses a non-empty dir, unknown slug exits `1` with closest slugs. Base URL override: `ASKEWLY_SITE_BUNDLE_URL`. |
+| `site list` / `site get` | No longer available. Whole-site bundles are not published since 2026-11-06; each site's design guide and notes are at https://ui.askewly.com/sites. |
 | `prompt <id>` | Paste-ready agent prompt: asset md URL + install command + usage rules + one-line instruction (0.6.0). |
 
 ## Why `verify` exists

package/dist/index.js

@@ -10,8 +10,8 @@ import { verifyDir } from "./verify.js";
 import { loadKnowledge, loadRecipes, loadTerms, loadTokens, loadTokensCss, searchKnowledge, searchTerms, tokensForTier, } from "./load.js";
 import { recall, RECALL_AXES } from "./data.js";
 import { assetUrl, buildPrompt, loadAssets, searchAssets, suggestAssets } from "./assets.js";
-import { getSite, listSites, siteNextStep, SiteError } from "./site.js";
-import { localRepo, LocalToolError, siteFind, siteResolve } from "./local.js";
+import { siteNextStep, SiteError } from "./site.js";
+import { localRepo, LocalToolError, siteFind, siteResolve, siteGet, siteSlugs } from "./local.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 // Set only by the local `askde` shim; npm and npx users never see the repo-only commands.
 const repo = localRepo();
@@ -475,44 +475,54 @@ program
     console.log(buildPrompt(assetOrFail(id)));
 });
 // M141 Ruling 11: 재현 사이트 구조 묶음(코드·텍스트 그대로, 이미지는 단색 빈 자리, 영상·폰트 제외)을 받는다.
-const siteCmd = program.command("site").description("reproduced-site bundles: structure only (code, layout, motion, text); images are blank placeholders, no video or fonts");
-siteCmd
-    .command("list")
-    .option("--json", "machine-readable output")
-    .description("list downloadable site bundles")
-    .action(async (options) => {
-    try {
-        const index = await listSites();
-        if (options.json)
-            return void console.log(JSON.stringify(index, null, 2));
-        for (const e of index)
-            console.log(`${e.slug}  ${(e.bytes / 1024).toFixed(0)} KB  ${e.files} files`);
-    }
-    catch (error) {
-        if (error instanceof SiteError)
-            fail(error.message);
-        throw error;
-    }
-});
-siteCmd
-    .command("get")
-    .argument("<slug>", "site slug, e.g. stripe-home")
-    .argument("[dir]", "target dir (default ./<slug>); must be empty or missing")
-    .description("download a site bundle, verify sha256, extract into [dir] (never overwrites)")
-    .action(async (slug, dir) => {
-    try {
-        const target = dir ?? slug;
-        const n = await getSite(slug, target);
-        console.log(`${n} files -> ${target}
-${siteNextStep(target)}`);
-    }
-    catch (error) {
-        if (error instanceof SiteError)
-            fail(error.message);
-        throw error;
-    }
-});
+const siteCmd = program
+    .command("site")
+    .description(repo ? "local: recreated sites in this repo" : "whole-site bundles are no longer published");
+const SITES_NOT_PUBLISHED = `Whole-site bundles are no longer published.
+See https://ui.askewly.com/sites for each site's design guide and notes, and use \`askewly-design find "<element>"\` for published parts.`;
+if (!repo) {
+    siteCmd.command("list").description("no longer available").action(() => fail(SITES_NOT_PUBLISHED));
+    siteCmd
+        .command("get")
+        .argument("[slug]")
+        .argument("[dir]")
+        .description("no longer available")
+        .action(() => fail(SITES_NOT_PUBLISHED));
+}
 if (repo) {
+    siteCmd
+        .command("list")
+        .option("--json", "machine-readable output")
+        .description("local: list recreated sites in this repo")
+        .action((options) => {
+        try {
+            const slugs = siteSlugs(repo);
+            console.log(options.json ? JSON.stringify(slugs, null, 2) : slugs.join("\n"));
+        }
+        catch (error) {
+            if (error instanceof LocalToolError)
+                fail(error.message);
+            throw error;
+        }
+    });
+    siteCmd
+        .command("get")
+        .argument("<slug>", "site slug, e.g. stripe-home")
+        .argument("[dir]", "target dir (default ./<slug>); must be empty or missing")
+        .description("local: pack a site from this repo and extract it into [dir] (never overwrites)")
+        .action((slug, dir) => {
+        try {
+            const target = dir ?? slug;
+            const n = siteGet(repo, slug, target);
+            console.log(`${n} files -> ${target}
+${siteNextStep(target)}`);
+        }
+        catch (error) {
+            if (error instanceof LocalToolError || error instanceof SiteError)
+                fail(error.message);
+            throw error;
+        }
+    });
     siteCmd
         .command("find")
         .argument("<query>", "element or site, e.g. menu")

package/dist/local.js

@@ -1,8 +1,10 @@
 // Repo-only commands for the local `askde` shim (cs724). They run the existing scripts, so the
 // repo keeps one source of truth, and they never appear for npm users.
 import { spawnSync } from "node:child_process";
-import { existsSync } from "node:fs";
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
 import path from "node:path";
+import { assertEmptyTarget, extractSiteZip, suggestSites } from "./site.js";
 export class LocalToolError extends Error {
 }
 export function localRepo() {
@@ -21,6 +23,44 @@ function runRepoTool(repo, command, script, args) {
         throw new LocalToolError(`could not run ${command}: ${result.error.message}`);
     return result.status ?? 1;
 }
+const PACK_SCRIPT = "scripts/recreate/pack-site-bundles.mjs";
+function runPack(repo, args) {
+    const file = path.join(repo, PACK_SCRIPT);
+    if (!existsSync(file))
+        throw new LocalToolError(`${PACK_SCRIPT} not found under ASKDE_REPO=${repo}`);
+    const result = spawnSync(process.execPath, [file, ...args], {
+        cwd: repo,
+        encoding: "utf8",
+        maxBuffer: 16 * 1024 * 1024,
+        env: { ...process.env, PYTHONUTF8: "1" },
+    });
+    if (result.error)
+        throw new LocalToolError(`could not run ${PACK_SCRIPT}: ${result.error.message}`);
+    if (result.status !== 0)
+        throw new LocalToolError(result.stderr.trim() || `${PACK_SCRIPT} exited ${result.status}`);
+    return result.stdout;
+}
+export function siteSlugs(repo) {
+    return runPack(repo, ["--list"]).split(/\r?\n/).filter(Boolean);
+}
+/** Packs one site from the repo into a throwaway folder and extracts it. Nothing leaves this machine. */
+export function siteGet(repo, slug, dir) {
+    const slugs = siteSlugs(repo);
+    if (!slugs.includes(slug)) {
+        const near = suggestSites(slugs, slug).map((s) => `  - ${s}`);
+        throw new LocalToolError(`unknown site "${slug}" — closest:\n${near.join("\n")}\nor: askde site list`);
+    }
+    assertEmptyTarget(dir);
+    const out = mkdtempSync(path.join(tmpdir(), "askde-site-"));
+    try {
+        runPack(repo, ["--out", out, slug]);
+        const [entry] = JSON.parse(readFileSync(path.join(out, "index.json"), "utf8"));
+        return extractSiteZip(readFileSync(path.join(out, entry.file)), dir);
+    }
+    finally {
+        rmSync(out, { recursive: true, force: true });
+    }
+}
 export function siteFind(repo, query, limit) {
     const python = process.platform === "win32" ? "python" : "python3";
     // `--` keeps a query like "--approve" from reaching catalog.py's write options.

package/dist/site.js

@@ -1,32 +1,11 @@
-// M141 Ruling 11: 재현 사이트 구조 묶음 — `site list` · `site get <slug> [dir]`.
+// 재현 사이트 구조 묶음의 압축 해제 — 로컬 `askde site get` 전용(2026-11-06 공개 배포 폐지).
 // 묶음 = scripts/recreate/pack-site-bundles.mjs 산출물(코드·텍스트 그대로, 이미지는 단색 빈 자리, 영상·폰트 제외).
 // 압축 해제는 node 내장 zlib 만 쓴다(새 의존성 없음).
-import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { inflateRawSync } from "node:zlib";
-export const SITE_BUNDLE_BASE_URL = "https://bundles.askewly.com";
 export class SiteError extends Error {
 }
-export function bundleBaseUrl() {
-    return (process.env.ASKEWLY_SITE_BUNDLE_URL || SITE_BUNDLE_BASE_URL).replace(/\/+$/, "");
-}
-async function fetchBuffer(url) {
-    let res;
-    try {
-        res = await fetch(url);
-    }
-    catch (error) {
-        throw new SiteError(`cannot reach ${url}: ${error.message}`);
-    }
-    if (!res.ok)
-        throw new SiteError(`GET ${url} -> HTTP ${res.status}`);
-    return Buffer.from(await res.arrayBuffer());
-}
-// 목록은 엣지 캐시를 건너뛴다 — zip 은 이름에 해시가 있어 캐시돼도 된다
-export async function fetchSiteIndex(base = bundleBaseUrl()) {
-    return JSON.parse((await fetchBuffer(`${base}/index.json?v=${Date.now()}`)).toString("utf8"));
-}
 function editDistance(a, b) {
     const row = Array.from({ length: b.length + 1 }, (_, j) => j);
     for (let i = 1; i <= a.length; i++) {
@@ -41,12 +20,12 @@ function editDistance(a, b) {
     return row[b.length];
 }
 /** 없는 slug 에 대한 근접 후보 — assets.ts suggestAssets 와 같은 규칙(부분 문자열 우선, 편집 거리). */
-export function suggestSites(index, slug, n = 3) {
+export function suggestSites(slugs, slug, n = 3) {
     const needle = slug.toLowerCase();
-    return index
-        .map((e) => {
-        const a = e.slug.toLowerCase();
-        return { slug: e.slug, key: (a.includes(needle) || needle.includes(a) ? 0 : 1000) + editDistance(a, needle) };
+    return slugs
+        .map((candidate) => {
+        const a = candidate.toLowerCase();
+        return { slug: candidate, key: (a.includes(needle) || needle.includes(a) ? 0 : 1000) + editDistance(a, needle) };
     })
         .sort((x, y) => x.key - y.key || x.slug.localeCompare(y.slug))
         .slice(0, n)
@@ -85,24 +64,13 @@ export function siteNextStep(dir) {
     }
     return `read ${path.join(dir, "ASKEWLY-BUNDLE.md")} for what was left out and how to run it`;
 }
-export async function listSites(base = bundleBaseUrl()) {
-    return fetchSiteIndex(base);
-}
-/** 묶음을 받아 sha256 대조 후 dir 에 푼다. 비어 있지 않은 폴더·해시 불일치·없는 slug 는 SiteError. 반환 = 푼 파일 수. */
-export async function getSite(slug, dir, base = bundleBaseUrl()) {
-    const index = await fetchSiteIndex(base);
-    const entry = index.find((e) => e.slug === slug);
-    if (!entry) {
-        const near = suggestSites(index, slug).map((s) => `  - ${s}`);
-        throw new SiteError(`unknown site "${slug}" — closest:\n${near.join("\n")}\nor: askewly-design site list`);
-    }
+export function assertEmptyTarget(dir) {
     if (existsSync(dir) && readdirSync(dir).length > 0)
         throw new SiteError(`${dir} is not empty — refusing to overwrite`);
-    const file = entry.file ?? `${slug}.zip`;
-    const zip = await fetchBuffer(`${base}/${file}`);
-    const sha = createHash("sha256").update(zip).digest("hex");
-    if (sha !== entry.sha256)
-        throw new SiteError(`sha256 mismatch for ${file} (expected ${entry.sha256}, got ${sha})`);
+}
+/** zip 을 dir 에 푼다. 비어 있지 않은 폴더·경로 탈출은 SiteError 이고 아무것도 쓰지 않는다. 반환 = 푼 파일 수. */
+export function extractSiteZip(zip, dir) {
+    assertEmptyTarget(dir);
     const files = readZip(zip);
     const root = path.resolve(dir);
     for (const f of files) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askewly/design",
-  "version": "0.7.0",
+  "version": "1.0.0",
   "description": "Query, inject, and verify the Askewly Design system (tokens, UI vocabulary, recipes) from your terminal or coding agent.",
   "license": "MIT",
   "homepage": "https://ui.askewly.com",