@askewly/design 0.4.5 → 0.5.1

package/dist/data.js

@@ -0,0 +1,90 @@
+// M110 앞단 — 레포 자산 조회 통합 (`data recall`).
+// design-intake.md §5단계와 askewly-design SKILL §2.7 이 약속해 온 `askewly data recall`
+// 이 유령 명령이었다(이 기기 어디에도 `data` 커맨드가 없었다) — 그 약속을 실재하게 만든다.
+//
+// 번들된 두 축(terms · recipes) + knowledge 축을 한 번에 훑는다. methodology/ 는
+// build-data.mjs 가 애초에 번들하지 않으므로(knowledge/*.md 만 읽는다) 여기서도 다루지
+// 않는다 — 새 데이터 로더를 만들지 않고 기존 load.ts 만 재사용한다는 이 step 의 원칙.
+// methodology 를 포함한 5축 통합 회수가 필요하면 `python ~/projects/second-brain/bin/data.py recall`
+// 로 보완한다(design-intake.md 가 그 경계를 함께 적는다).
+import { loadKnowledge, loadRecipes, loadTerms, searchKnowledge, searchTerms, } from "./load.js";
+export const RECALL_AXES = ["terms", "recipes", "knowledge"];
+function summarize(text, max = 120) {
+    if (!text)
+        return "";
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length > max ? `${oneLine.slice(0, max - 1)}…` : oneLine;
+}
+/** Case-insensitive substring search over id, name, pattern_group, body (low weight). */
+function searchRecipes(recipes, query) {
+    const needle = query.trim().toLowerCase();
+    if (!needle)
+        return [];
+    const scored = [];
+    for (const recipe of recipes) {
+        const id = recipe.id.toLowerCase();
+        const name = (recipe.name ?? "").toLowerCase();
+        const group = (recipe.pattern_group ?? "").toLowerCase();
+        const body = recipe.body?.toLowerCase() ?? "";
+        let score = 0;
+        if (id === needle || name === needle)
+            score = 100;
+        else if (id.includes(needle) || name.includes(needle))
+            score = 60;
+        else if (group.includes(needle))
+            score = 40;
+        else if (body.includes(needle))
+            score = 20;
+        if (score > 0)
+            scored.push({ recipe, score });
+    }
+    return scored.sort((a, b) => b.score - a.score || a.recipe.id.localeCompare(b.recipe.id)).map((s) => s.recipe);
+}
+function termHit(term) {
+    return {
+        axis: "terms",
+        id: term.id,
+        path: `docs/ui-vocabulary/terms.yml#${term.id}`,
+        summary: summarize(term.one_liner ?? term.en?.name ?? term.id),
+    };
+}
+function recipeHit(recipe) {
+    return {
+        axis: "recipes",
+        id: recipe.id,
+        path: recipe.source_path,
+        summary: summarize(`${recipe.name ? `${recipe.name} (${recipe.pattern_group ?? "-"})` : recipe.id}${recipe.status ? ` [${recipe.status}]` : ""}`),
+        status: recipe.status,
+    };
+}
+function knowledgeHit(doc) {
+    return {
+        axis: "knowledge",
+        id: doc.id,
+        path: doc.source_path,
+        summary: summarize(doc.description),
+    };
+}
+/**
+ * Search terms + recipes + knowledge in one pass and return path + one-line
+ * summary per hit. This is an index, not the source text — the caller must
+ * still open `path` and read the body before judging.
+ */
+export function recall(query, limit) {
+    const terms = searchTerms(loadTerms(), query).map(termHit);
+    const recipes = searchRecipes(loadRecipes(), query).map(recipeHit);
+    const knowledge = searchKnowledge(loadKnowledge(), query).map(knowledgeHit);
+    // Interleave by axis (round-robin) so a query that happens to match many
+    // terms doesn't crowd recipes/knowledge out of a small --limit window.
+    const merged = [];
+    const maxLen = Math.max(terms.length, recipes.length, knowledge.length);
+    for (let i = 0; i < maxLen; i++) {
+        if (terms[i])
+            merged.push(terms[i]);
+        if (recipes[i])
+            merged.push(recipes[i]);
+        if (knowledge[i])
+            merged.push(knowledge[i]);
+    }
+    return merged.slice(0, Math.max(0, limit));
+}

package/dist/index.js

@@ -5,8 +5,10 @@ import { Command } from "commander";
 import { addRecipe, initProject, InjectError } from "./inject.js";
 import { runKickstart, KickstartError } from "./kickstart.js";
 import { DEFAULT_TYPOGRAPHY_THRESHOLD } from "./typography.js";
+import { MASCOT_POSES, renderMascot } from "./mascot.js";
 import { verifyDir } from "./verify.js";
 import { loadKnowledge, loadRecipes, loadTerms, loadTokens, loadTokensCss, searchKnowledge, searchTerms, tokensForTier, } from "./load.js";
+import { recall, RECALL_AXES } from "./data.js";
 const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 const program = new Command();
 program
@@ -316,4 +318,49 @@ recipes
     console.log("");
     console.log(recipe.body);
 });
+// 어스큐리 수달 — 브랜드 마스코트. 사람 눈 전용 표면이라 --json 이 없다(기계 소비 출력에
+// 캐릭터를 섞지 않는다 — docs/design-system/mascot.md §3). 색은 TTY 에서만 기본 ON.
+program
+    .command("mascot")
+    .argument("[pose]", `pose: ${MASCOT_POSES.join(" | ")}`, "lying")
+    .option("--no-color", "print without ANSI color (piped output is plain by default)")
+    .description("print the Askewly otter mascot (lavender half-block pixel art)")
+    .action((pose, options) => {
+    if (!MASCOT_POSES.includes(pose)) {
+        fail(`unknown pose "${pose}" — expected one of: ${MASCOT_POSES.join(", ")}`);
+    }
+    const color = options.color && Boolean(process.stdout.isTTY);
+    console.log(renderMascot(pose, { color }));
+});
+const data = program
+    .command("data")
+    .description("query bundled repo assets across axes (terms, recipes, knowledge) in one pass");
+data
+    .command("recall")
+    .argument("<query>", "text to match across terms / recipes / knowledge")
+    .option("--limit <n>", "max results", "5")
+    .option("--json", "machine-readable output")
+    .description("search terms + recipes + knowledge in one pass — an index of paths, not the source text")
+    .action((query, options) => {
+    const limit = Number(options.limit) || 5;
+    const hits = recall(query, limit);
+    if (options.json) {
+        console.log(JSON.stringify({
+            note: "index only — read `path` before judging",
+            axes: RECALL_AXES,
+            query,
+            hits,
+        }, null, 2));
+        return;
+    }
+    console.log("색인이지 본문이 아니다 — 후보 경로를 받은 뒤 판단은 본문을 읽고 한다.");
+    if (hits.length === 0) {
+        console.log(`no matches for "${query}" across axes: ${RECALL_AXES.join(", ")} (methodology/ is not bundled here — try: python ~/projects/second-brain/bin/data.py recall "${query}")`);
+        return;
+    }
+    for (const hit of hits) {
+        console.log(`[${hit.axis}] ${hit.id}  —  ${hit.path}`);
+        console.log(`    ${hit.summary}`);
+    }
+});
 program.parse();

package/dist/inject.js

@@ -45,6 +45,19 @@ export function extractCodeSnippet(recipe) {
     if (recipe.code_source) {
         return recipe.code_source.trimEnd() + "\n";
     }
+    // 영상 자산은 코드가 **있는데도** 배급하지 않는다 — Remotion 런타임 위에서만 돌아서,
+    // 여기서 써 주면 remotion 없는 프로젝트가 설치 직후 깨진다. 「없다」가 아니라 「여기로
+    // 가라」로 답한다 (M95 step-8 · docs/design-system/video-contract.md §6).
+    if (recipe.surface_refs?.includes("video")) {
+        throw new InjectError([
+            `recipe "${recipe.id}" is a video asset — not distributed through add.`,
+            "  It runs only inside Remotion (useCurrentFrame), so writing it here would break this project.",
+            "  Read the recipe and the element source, then rebuild it in your own Remotion project:",
+            `    https://ui.askewly.com/llms/${recipe.source_path}`,
+            ...(recipe.code_asset ? [`    https://ui.askewly.com/llms/${recipe.code_asset}`] : []),
+            "  Medium contract: https://ui.askewly.com/llms/docs/design-system/video-contract.md",
+        ].join("\n"));
+    }
     throw new InjectError(`recipe "${recipe.id}" has no fenced code block under ## Code`);
 }
 /** Extracts list items of a `## <title>` section (used for Checks / Anti-patterns notes). */

package/dist/mascot.js

@@ -0,0 +1,43 @@
+// 어스큐리 수달 — Askewly 브랜드 마스코트 (M83, 2026-08-28).
+// 정본은 레포 docs/design-system/mascot.md + mascot/*.map.txt (픽셀맵). 아래 문자열은
+// 파생 사본이다 — 손편집 금지, 맵을 고치고 재렌더해서 옮긴다.
+// 사용 규칙(정본 §3): 라벤더 #B298DC 단색 고정 · 등폭 전제 · 기계 소비 출력 금지.
+export const MASCOT_POSES = ["lying", "standing", "sleepy", "mini"];
+const ART = {
+    lying: `         ▄██▄   ▄██▄
+         █ ██   █ ██
+       ▄██████████████████▄
+█▄    █████████████████████
+ ▀█▄  ████  ████  █████████
+  ▀██▄████  ████  █████████
+      ▀███████████████████▀
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀`,
+    standing: `    ▄██▄   ▄██▄
+    █ ██   █ ██
+  ▄██████████████▄
+  ███  ████  █████
+  ███  ████  █████
+  ████████████████
+  ████████████████
+  ▀████▀▀▀████▀▀██
+   ████   ████  ▀███▄▄▄`,
+    sleepy: `         ▄██▄   ▄██▄
+         █ ██   █ ██
+       ▄██████████████████▄
+█▄    █████████████████████
+ ▀█▄  █████████████████████
+  ▀██▄███    ██    ████████
+      ▀███████████████████▀
+        ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀`,
+    mini: `  ▄██▄▄▄▄██▄
+  ██████████
+  ██  ██  ██
+  ▀████████▀`,
+};
+/** askewly.lavender #B298DC — ANSI 24-bit. */
+const LAVENDER = "";
+const RESET = "";
+export function renderMascot(pose, options) {
+    const art = ART[pose];
+    return options.color ? `${LAVENDER}${art}${RESET}` : art;
+}

package/package.json

@@ -1,50 +1,50 @@
-{
-  "name": "@askewly/design",
-  "version": "0.4.5",
-  "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",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lumatic2/ui-dictionary.git",
-    "directory": "packages/cli"
-  },
-  "keywords": [
-    "design-system",
-    "design-tokens",
-    "linter",
-    "ui",
-    "coding-agent"
-  ],
-  "type": "module",
-  "bin": {
-    "askewly-design": "./dist/index.js"
-  },
-  "files": [
-    "dist",
-    "data",
-    "README.md",
-    "LICENSE"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build:data": "node scripts/build-data.mjs",
-    "build": "npm run build:data && tsc",
-    "test": "vitest run",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "commander": "^13.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.0",
-    "typescript": "^5.7.0",
-    "vitest": "^3.0.0",
-    "yaml": "^2.6.0"
-  }
-}
+{
+  "name": "@askewly/design",
+  "version": "0.5.1",
+  "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",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lumatic2/ui-dictionary.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "design-system",
+    "design-tokens",
+    "linter",
+    "ui",
+    "coding-agent"
+  ],
+  "type": "module",
+  "bin": {
+    "askewly-design": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "data",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build:data": "node scripts/build-data.mjs",
+    "build": "npm run build:data && tsc",
+    "test": "vitest run",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "yaml": "^2.6.0"
+  }
+}