lazyclaude-ai 0.1.1 → 0.1.2

package/README.md

@@ -5,8 +5,8 @@ simple local activation, prompt-triggered ultrawork discipline,
 planner/executor/reviewer agents, lifecycle hooks, MCP scaffolding, and
 LSP-backed code checks.
 
-The current public package is `lazyclaude-ai@0.1.0`, and this checkout prepares
-the next `0.1.1` patch for personal install convenience. The repo can remain
+The current public package is `lazyclaude-ai@0.1.1`, and this checkout prepares
+the next `0.1.2` patch for personal install convenience. The repo can remain
 private and quiet; publishing to npm here does not imply public repo promotion,
 marketplace publication, or advertisement. Future package releases still require
 explicit user approval.
@@ -73,10 +73,11 @@ Inside Claude Code, reload local plugin metadata after edits:
 ```
 
 If an OMC/omc Claude plugin is installed, do not co-load it with LazyClaude
-while testing this MVP. LazyClaude is loaded directly by `--plugin-dir` and does
-not ship a root Claude marketplace skeleton. If user-level OMC creates a local
-`.omc/` state directory during smoke tests, LazyClaude ignores and excludes that
-directory from git and npm package surfaces.
+while testing this MVP. Local checkout tests use `--plugin-dir`, and npm installs
+create only a LazyClaude-managed local marketplace under the user's LazyClaude
+home. The checkout does not ship a root Claude marketplace skeleton. If
+user-level OMC creates a local `.omc/` state directory during smoke tests,
+LazyClaude ignores and excludes that directory from git and npm package surfaces.
 
 ## ULW Usage
 

package/README_ko-KR.md

@@ -5,8 +5,8 @@ LazyClaude는 LazyCodex 스타일의 작업 흐름을 Claude Code에 맞게 옮
 실행자 에이전트, hooks, MCP scaffold, LSP doctor를 Claude Code 플러그인
 형태로 제공합니다.
 
-현재 공개 npm 패키지는 `lazyclaude-ai@0.1.0`이고, 이 checkout은 다음
-`0.1.1` 패치 배포 후보를 준비합니다. 목적은 다른 PC에서도 빠르게
+현재 공개 npm 패키지는 `lazyclaude-ai@0.1.1`이고, 이 checkout은 다음
+`0.1.2` 패치 배포 후보를 준비합니다. 목적은 다른 PC에서도 빠르게
 설치하기 위한 개인용 배포물입니다. 저장소는 비공개 저장소로 유지할 수
 있고, npm 배포가 곧 홍보, 공개 저장소 운영, Claude marketplace 등록을
 의미하지는 않습니다. 새 버전 배포는 항상 별도의 명시적 승인 후에
@@ -54,9 +54,10 @@ npx --yes lazyclaude-ai uninstall
 ```
 
 installer는 `lazyclaude@lazyclaude-ai`를 Claude Code user plugin registry
-아래의 `~/.claude/plugins`에 등록하고 `settings.json`의 `enabledPlugins`에
-활성 상태를 기록합니다. 따라서 매번 긴 `--plugin-dir` 명령을 입력할
-필요가 없습니다. 격리 테스트가 필요할 때만
+아래의 `~/.claude/plugins`에 등록하고 `settings.json`의 `enabledPlugins`와
+LazyClaude 전용 local marketplace 항목, `known_marketplaces.json`을 함께
+기록합니다. 따라서 매번 긴 `--plugin-dir` 명령을 입력할 필요가 없습니다.
+격리 테스트가 필요할 때만
 `CLAUDE_CONFIG_DIR=/some/path`와 `LAZYCLAUDE_HOME=/some/path`를 지정하세요.
 
 ## 로컬 개발
@@ -75,10 +76,12 @@ Claude Code 안에서 플러그인 메타데이터를 다시 읽고 싶으면
 ```
 
 기존 OMC/omc Claude 플러그인이 설치되어 있다면 MVP 테스트 중에는
-LazyClaude와 함께 co-load하지 않는 것을 권장합니다. LazyClaude는
-`--plugin-dir`로 직접 로드하며 root Claude marketplace skeleton을 배포하지
-않습니다. user-level OMC가 검증 중 `.omc/` 상태 디렉터리를 만들더라도
-LazyClaude는 이를 git 및 npm package surface에서 제외합니다.
+LazyClaude와 함께 co-load하지 않는 것을 권장합니다. 로컬 checkout 테스트는
+`--plugin-dir`로 직접 로드하고, npm 설치는 사용자 홈 아래에 LazyClaude가
+관리하는 local marketplace만 만듭니다. root Claude marketplace skeleton은
+저장소 checkout에 배포하지 않습니다. user-level OMC가 검증 중 `.omc/`
+상태 디렉터리를 만들더라도 LazyClaude는 이를 git 및 npm package surface에서
+제외합니다.
 
 ## ULW 사용법
 

package/RELEASE_CHECKLIST.md

@@ -1,8 +1,8 @@
 # LazyClaude Release Checklist
 
-Status: quiet public npm package `lazyclaude-ai@0.1.0` is published for
+Status: quiet public npm package `lazyclaude-ai@0.1.1` is published for
 personal install convenience after explicit user approval. This checkout is
-prepared as the next `0.1.1` patch candidate until the user explicitly approves
+prepared as the next `0.1.2` patch candidate until the user explicitly approves
 another publish.
 
 DO NOT publish a new version of LazyClaude, run `npm publish`, push release
@@ -40,9 +40,10 @@ Use this track after an approved npm package version exists:
 3. Start Claude Code with the normal `claude` command.
 
 The installer should register `lazyclaude@lazyclaude-ai` in Claude Code's user
-plugin registry and `settings.json` `enabledPlugins`. Do not ask users to type a
-generated command that shells out to `npx --yes lazyclaude-ai path` for normal
-npm installs.
+plugin registry, `settings.json` `enabledPlugins`, and the LazyClaude-managed
+local marketplace metadata needed by `claude plugin details`. Do not ask users
+to type a generated command that shells out to `npx --yes lazyclaude-ai path` for
+normal npm installs.
 
 ## Quiet Public NPM Package Release Or Update
 
@@ -92,10 +93,13 @@ rollback action with user approval:
 Local checkout testing still uses `claude --plugin-dir ./plugins/lazyclaude`.
 NPM installs should use the global Claude user plugin registry and normal
 `claude` launches. A root Claude marketplace file is intentionally not shipped
-because users may already have an OMC/omc marketplace or plugin installed. Do
-not add a local or remote marketplace entry without explicit user approval. If
-user-level OMC creates `.omc/` state during validation, keep it ignored and
-confirm it is absent from the package dry-run.
+because users may already have an OMC/omc marketplace or plugin installed. The
+npm installer creates a LazyClaude-managed local marketplace under
+`LAZYCLAUDE_HOME` and registers only `lazyclaude-ai` in Claude's user marketplace
+metadata so skills and hooks appear in `claude plugin details`. Do not add a
+remote marketplace entry without explicit user approval. If user-level OMC
+creates `.omc/` state during validation, keep it ignored and confirm it is
+absent from the package dry-run.
 
 ## Rollback
 

package/bin/lazyclaude-ai.js

@@ -43,9 +43,13 @@ const currentRoot = (home = lazyHome()) => join(home, "current");
 const pluginPathForRoot = (installRoot) => join(installRoot, "plugins", "lazyclaude");
 const claudePluginRoot = (home = claudeHome()) => join(home, "plugins", "cache", "lazyclaude-ai", "lazyclaude", version);
 const installedPluginsPath = (home = claudeHome()) => join(home, "plugins", "installed_plugins.json");
+const knownMarketplacesPath = (home = claudeHome()) => join(home, "plugins", "known_marketplaces.json");
 const claudeSettingsPath = (home = claudeHome()) => join(home, "settings.json");
 const pluginKey = "lazyclaude@lazyclaude-ai";
+const marketplaceName = "lazyclaude-ai";
 const intendedPluginPath = (home = claudeHome()) => claudePluginRoot(home);
+const marketplaceRoot = (home = lazyHome()) => join(home, "marketplaces", marketplaceName);
+const marketplacePluginPath = (home = lazyHome()) => join(marketplaceRoot(home), "plugins", "lazyclaude");
 const sourcePluginPath = () => join(root, "plugins", "lazyclaude");
 
 const printUsage = () => {
@@ -88,23 +92,98 @@ const writeClaudeSettings = (settings, home = claudeHome()) => {
   writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
 };
 
-const enableClaudePlugin = (home = claudeHome()) => {
+const readKnownMarketplaces = (home = claudeHome()) => {
+  const path = knownMarketplacesPath(home);
+  if (!existsSync(path)) return {};
+  return JSON.parse(readFileSync(path, "utf8"));
+};
+
+const writeKnownMarketplaces = (knownMarketplaces, home = claudeHome()) => {
+  const path = knownMarketplacesPath(home);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(knownMarketplaces, null, 2)}\n`);
+};
+
+const marketplaceSource = (marketplacePath) => ({
+  source: "directory",
+  path: marketplacePath,
+});
+
+const writeLocalMarketplace = (legacyHome = lazyHome()) => {
+  const rootPath = marketplaceRoot(legacyHome);
+  const targetPlugin = marketplacePluginPath(legacyHome);
+  rmSync(rootPath, { recursive: true, force: true });
+  mkdirSync(dirname(targetPlugin), { recursive: true });
+  cpSync(sourcePluginPath(), targetPlugin, { recursive: true });
+  const marketplaceManifestPath = join(rootPath, ".claude-plugin", "marketplace.json");
+  mkdirSync(dirname(marketplaceManifestPath), { recursive: true });
+  writeFileSync(
+    marketplaceManifestPath,
+    `${JSON.stringify(
+      {
+        $schema: "https://anthropic.com/claude-code/marketplace.schema.json",
+        name: marketplaceName,
+        description: "Local LazyClaude npm-installed marketplace.",
+        owner: {
+          name: "LazyClaude contributors",
+        },
+        plugins: [
+          {
+            name: "lazyclaude",
+            description: packageJson.description,
+            author: {
+              name: "LazyClaude contributors",
+            },
+            source: "./plugins/lazyclaude",
+            category: "development",
+            homepage: "https://github.com/code-yeongyu/lazycodex",
+          },
+        ],
+      },
+      null,
+      2,
+    )}\n`,
+  );
+  return rootPath;
+};
+
+const registerMarketplace = (marketplacePath, home = claudeHome()) => {
   const settings = readClaudeSettings(home);
   settings.enabledPlugins = settings.enabledPlugins ?? {};
   settings.enabledPlugins[pluginKey] = true;
+  settings.extraKnownMarketplaces = settings.extraKnownMarketplaces ?? {};
+  settings.extraKnownMarketplaces[marketplaceName] = {
+    source: marketplaceSource(marketplacePath),
+  };
   writeClaudeSettings(settings, home);
+
+  const knownMarketplaces = readKnownMarketplaces(home);
+  knownMarketplaces[marketplaceName] = {
+    source: marketplaceSource(marketplacePath),
+    installLocation: marketplacePath,
+    lastUpdated: new Date().toISOString(),
+  };
+  writeKnownMarketplaces(knownMarketplaces, home);
 };
 
-const disableClaudePlugin = (home = claudeHome()) => {
+const unregisterMarketplace = (home = claudeHome()) => {
   const settingsPath = claudeSettingsPath(home);
-  if (!existsSync(settingsPath)) return;
-  const settings = readClaudeSettings(home);
-  if (!settings.enabledPlugins) return;
-  delete settings.enabledPlugins[pluginKey];
-  writeClaudeSettings(settings, home);
+  if (existsSync(settingsPath)) {
+    const settings = readClaudeSettings(home);
+    if (settings.enabledPlugins) delete settings.enabledPlugins[pluginKey];
+    if (settings.extraKnownMarketplaces) delete settings.extraKnownMarketplaces[marketplaceName];
+    writeClaudeSettings(settings, home);
+  }
+
+  const knownPath = knownMarketplacesPath(home);
+  if (existsSync(knownPath)) {
+    const knownMarketplaces = readKnownMarketplaces(home);
+    delete knownMarketplaces[marketplaceName];
+    writeKnownMarketplaces(knownMarketplaces, home);
+  }
 };
 
-const registerClaudePlugin = (installRoot, home = claudeHome()) => {
+const registerClaudePlugin = (installRoot, marketplacePath, home = claudeHome()) => {
   const registry = readInstalledPlugins(home);
   const now = new Date().toISOString();
   const existing = registry.plugins[pluginKey]?.[0] ?? {};
@@ -120,7 +199,7 @@ const registerClaudePlugin = (installRoot, home = claudeHome()) => {
     },
   ];
   writeInstalledPlugins(registry, home);
-  enableClaudePlugin(home);
+  registerMarketplace(marketplacePath, home);
 };
 
 const unregisterClaudePlugin = (home = claudeHome()) => {
@@ -158,10 +237,12 @@ const install = ({ dryRun }) => {
   const legacyHome = lazyHome();
   const targetPlugin = claudePluginRoot(home);
   const sourcePlugin = sourcePluginPath();
+  const targetMarketplace = marketplaceRoot(legacyHome);
 
   if (dryRun) {
     process.stdout.write(`DRY_RUN: install LazyClaude ${version}\n`);
     process.stdout.write(`Would copy: ${sourcePlugin} -> ${targetPlugin}\n`);
+    process.stdout.write(`Would create local marketplace: ${targetMarketplace}\n`);
     process.stdout.write(`Would register Claude plugin: ${pluginKey}\n`);
     process.stdout.write("Launch with: claude\n");
     return;
@@ -174,7 +255,8 @@ const install = ({ dryRun }) => {
   rmSync(targetPlugin, { recursive: true, force: true });
   mkdirSync(dirname(targetPlugin), { recursive: true });
   cpSync(sourcePlugin, targetPlugin, { recursive: true });
-  registerClaudePlugin(targetPlugin, home);
+  const localMarketplace = writeLocalMarketplace(legacyHome);
+  registerClaudePlugin(targetPlugin, localMarketplace, home);
 
   const legacyRoot = versionRoot(legacyHome);
   rmSync(legacyRoot, { recursive: true, force: true });
@@ -184,6 +266,7 @@ const install = ({ dryRun }) => {
 
   process.stdout.write(`INSTALL_PASS: LazyClaude ${version} installed\n`);
   process.stdout.write(`Claude plugin: ${pluginKey}\n`);
+  process.stdout.write(`Marketplace: ${localMarketplace}\n`);
   process.stdout.write(`Plugin path: ${intendedPluginPath(home)}\n`);
   process.stdout.write("Launch with: claude\n");
 };
@@ -229,6 +312,13 @@ const doctor = ({ dryRun }) => {
       fail("Claude plugin validation failed.");
     }
     process.stdout.write("CLAUDE_PLUGIN_VALIDATE_PASS\n");
+    const details = spawnSync("claude", ["plugin", "details", pluginKey], { encoding: "utf8" });
+    if (details.status !== 0) {
+      if (details.stdout) process.stderr.write(details.stdout);
+      if (details.stderr) process.stderr.write(details.stderr);
+      fail("Claude plugin details failed.");
+    }
+    process.stdout.write("CLAUDE_PLUGIN_DETAILS_PASS\n");
   }
 
   process.stdout.write(`Plugin path: ${pluginPath}\n`);
@@ -261,13 +351,14 @@ const uninstall = ({ dryRun }) => {
   const home = lazyHome();
   const pluginCacheRoot = join(claudeHome(), "plugins", "cache", "lazyclaude-ai");
   if (dryRun) {
-    process.stdout.write(`DRY_RUN: remove ${join(home, "lazyclaude-ai")}, ${currentRoot(home)}, ${pluginCacheRoot}, ${pluginKey}, and its enabledPlugins entry\n`);
+    process.stdout.write(`DRY_RUN: remove ${join(home, "lazyclaude-ai")}, ${currentRoot(home)}, ${marketplaceRoot(home)}, ${pluginCacheRoot}, ${pluginKey}, and its marketplace/settings entries\n`);
     return;
   }
   rmSync(currentRoot(home), { recursive: true, force: true });
   rmSync(join(home, "lazyclaude-ai"), { recursive: true, force: true });
+  rmSync(marketplaceRoot(home), { recursive: true, force: true });
   unregisterClaudePlugin();
-  disableClaudePlugin();
+  unregisterMarketplace();
   rmSync(pluginCacheRoot, { recursive: true, force: true });
   process.stdout.write("UNINSTALL_PASS\n");
 };

package/docs/migration.md

@@ -38,9 +38,10 @@ claude
 ```
 
 The installer writes the user plugin cache, `plugins/installed_plugins.json`,
-and the `settings.json` `enabledPlugins` entry for `lazyclaude@lazyclaude-ai`.
+the `settings.json` `enabledPlugins` entry for `lazyclaude@lazyclaude-ai`, and
+a LazyClaude-managed local marketplace entry in `known_marketplaces.json`.
 This keeps installation convenient without requiring public repo promotion,
-manual `--plugin-dir` launch commands, or a Claude marketplace entry.
+manual `--plugin-dir` launch commands, or a remote Claude marketplace entry.
 
 If OMC/omc is already installed in Claude Code, keep it disabled or start a
 separate Claude Code session without OMC while testing LazyClaude. This repo no

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lazyclaude-ai",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Claude Code-native LazyCodex-style workflow distribution.",
   "type": "module",
   "bin": {

package/plugins/lazyclaude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "lazyclaude",
   "description": "Claude Code-native LazyCodex-style workflow plugin.",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "author": {
     "name": "LazyClaude contributors"
   },

package/scripts/qa-portable-install.sh

@@ -71,13 +71,35 @@ if [ ! -f "$TMP_CLAUDE_HOME/settings.json" ]; then
   echo "INSTALL_FAIL"
   exit 1
 fi
+if [ ! -f "$TMP_CLAUDE_HOME/plugins/known_marketplaces.json" ]; then
+  echo "INSTALL_FAIL: Claude known marketplaces missing" >> "$EVIDENCE"
+  echo "INSTALL_FAIL"
+  exit 1
+fi
+if [ ! -f "$TMP_HOME/marketplaces/lazyclaude-ai/.claude-plugin/marketplace.json" ]; then
+  echo "INSTALL_FAIL: LazyClaude local marketplace missing" >> "$EVIDENCE"
+  echo "INSTALL_FAIL"
+  exit 1
+fi
 node -e 'const fs = require("fs"); const p = process.argv[1]; const registry = JSON.parse(fs.readFileSync(`${p}/plugins/installed_plugins.json`, "utf8")); const entry = registry.plugins["lazyclaude@lazyclaude-ai"]?.[0]; if (!entry || entry.scope !== "user" || !entry.installPath.includes("/plugins/cache/lazyclaude-ai/lazyclaude/")) process.exit(1);' "$TMP_CLAUDE_HOME"
-node -e 'const fs = require("fs"); const p = process.argv[1]; const settings = JSON.parse(fs.readFileSync(`${p}/settings.json`, "utf8")); if (settings.enabledPlugins?.["lazyclaude@lazyclaude-ai"] !== true) process.exit(1);' "$TMP_CLAUDE_HOME"
+node -e 'const fs = require("fs"); const p = process.argv[1]; const h = process.argv[2]; const settings = JSON.parse(fs.readFileSync(`${p}/settings.json`, "utf8")); const market = settings.extraKnownMarketplaces?.["lazyclaude-ai"]; if (settings.enabledPlugins?.["lazyclaude@lazyclaude-ai"] !== true || market?.source?.source !== "directory" || market.source.path !== `${h}/marketplaces/lazyclaude-ai`) process.exit(1);' "$TMP_CLAUDE_HOME" "$TMP_HOME"
+node -e 'const fs = require("fs"); const p = process.argv[1]; const h = process.argv[2]; const known = JSON.parse(fs.readFileSync(`${p}/plugins/known_marketplaces.json`, "utf8")); const market = known["lazyclaude-ai"]; if (market?.source?.source !== "directory" || market.installLocation !== `${h}/marketplaces/lazyclaude-ai`) process.exit(1);' "$TMP_CLAUDE_HOME" "$TMP_HOME"
 echo "INSTALL_PASS" >> "$EVIDENCE"
 
 run_step DOCTOR node "$ROOT/bin/lazyclaude-ai.js" doctor
 echo "DOCTOR_PASS" >> "$EVIDENCE"
 
+if command -v claude >/dev/null 2>&1; then
+  run_step CLAUDE_PLUGIN_DETAILS claude plugin details lazyclaude@lazyclaude-ai
+  if ! grep -q "Skills (7)" "$EVIDENCE" || ! grep -q "ulw-loop" "$EVIDENCE" || ! grep -q "ulw-plan" "$EVIDENCE" || ! grep -q "Hooks (4)" "$EVIDENCE"; then
+    echo "CLAUDE_PLUGIN_DETAILS_FAIL: expected LazyClaude skills/hooks inventory" >> "$EVIDENCE"
+    echo "CLAUDE_PLUGIN_DETAILS_FAIL"
+    exit 1
+  fi
+else
+  echo "CLAUDE_PLUGIN_DETAILS_SKIP: claude executable not found" >> "$EVIDENCE"
+fi
+
 run_step DRY_RUN_UNINSTALL node "$ROOT/bin/lazyclaude-ai.js" --dry-run uninstall
 if [ ! -d "$PLUGIN_PATH" ]; then
   echo "DRY_RUN_UNINSTALL_FAIL: plugin removed during dry-run" >> "$EVIDENCE"
@@ -91,6 +113,7 @@ if [ -e "$TMP_HOME/current" ] || [ -e "$TMP_HOME/lazyclaude-ai" ] || [ -e "$TMP_
   exit 1
 fi
 node -e 'const fs = require("fs"); const p = process.argv[1]; const settings = JSON.parse(fs.readFileSync(`${p}/settings.json`, "utf8")); if (settings.enabledPlugins?.["lazyclaude@lazyclaude-ai"] !== undefined) process.exit(1);' "$TMP_CLAUDE_HOME"
+node -e 'const fs = require("fs"); const p = process.argv[1]; const settings = JSON.parse(fs.readFileSync(`${p}/settings.json`, "utf8")); const known = JSON.parse(fs.readFileSync(`${p}/plugins/known_marketplaces.json`, "utf8")); if (settings.extraKnownMarketplaces?.["lazyclaude-ai"] !== undefined || known["lazyclaude-ai"] !== undefined) process.exit(1);' "$TMP_CLAUDE_HOME"
 echo "UNINSTALL_PASS" >> "$EVIDENCE"
 
 cleanup