phasegate 0.160.3 → 0.160.4

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.160.4] - 2026-05-14
+
+### Fixed
+
+- **WI-184 — skill catalog CLI** — fixes `phasegate skills list` so guidance-category skills no longer crash an undefined accumulator, shares the `SKILL.md` catalog path with `skills info`, and covers empty skill catalogs.
+
 ## [0.160.3] - 2026-05-14
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.3",
+  "version": "0.160.4",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/harness/main.ts

@@ -6,6 +6,7 @@
  * @work-item-id WI-171 / WI-172 / WI-173
  * @work-item-id WI-175
  * @work-item-id WI-176
+ * @work-item-id WI-184
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。
@@ -64,7 +65,9 @@ import {
   deploySkills,
   getCategoryForSkill,
   getHarnessVersion,
+  getSkillMarkdownPath,
   initHarnessConfig,
+  listAvailableSkillNames,
 } from "./setup/skill-deployer.js";
 import { createSkillQualityHandlers } from "./skill-quality/composition-root.js";
 import { createTraceabilityModelModule } from "./traceability-model/composition-root.js";
@@ -2753,25 +2756,16 @@ Examples:
       // ── skills ──
       case "skills": {
         const subCommand = args[1];
-        const skillsRoot = join(harnessRoot, "skills");
 
         if (subCommand === "list") {
-          const { promises: fs } = await import("node:fs");
-          const entries = await fs.readdir(skillsRoot, { withFileTypes: true });
-          const skills: string[] = [];
-          for (const entry of entries) {
-            if (entry.isDirectory()) {
-              try {
-                await fs.access(join(skillsRoot, entry.name, "SKILL.md"));
-                skills.push(entry.name);
-              } catch {
-                // skip directories without SKILL.md
-              }
-            }
-          }
-          skills.sort();
-
-          const grouped: Record<string, string[]> = { core: [], aidlc: [], utility: [], unknown: [] };
+          const skills = await listAvailableSkillNames(harnessRoot);
+          const grouped: Record<"core" | "aidlc" | "utility" | "guidance" | "unknown", string[]> = {
+            core: [],
+            aidlc: [],
+            utility: [],
+            guidance: [],
+            unknown: [],
+          };
           for (const name of skills) {
             const cat = getCategoryForSkill(name) ?? "unknown";
             grouped[cat].push(name);
@@ -2783,8 +2777,9 @@ Examples:
             core: "Core — Quality Defense",
             aidlc: "AIDLC — Development Workflow",
             utility: "Utility",
+            guidance: "Guidance",
           };
-          for (const cat of ["core", "aidlc", "utility", "unknown"] as const) {
+          for (const cat of ["core", "aidlc", "utility", "guidance", "unknown"] as const) {
             if (grouped[cat].length === 0) continue;
             const label = labels[cat] ?? "Other";
             console.log(`  [${label}] (${grouped[cat].length})`);
@@ -2803,7 +2798,7 @@ Examples:
             process.exit(2);
           }
           const { promises: fs } = await import("node:fs");
-          const skillMdPath = join(skillsRoot, skillName, "SKILL.md");
+          const skillMdPath = getSkillMarkdownPath(harnessRoot, skillName);
           try {
             const content = await fs.readFile(skillMdPath, "utf-8");
             console.log(content);

package/scripts/harness/setup/skill-deployer.ts

@@ -2,6 +2,7 @@
 // @layer infrastructure
 // @work-item-id WI-086 / WI-087
 // @work-item-id WI-127
+// @work-item-id WI-184
 // Note: import.meta.url を使わず、呼び出し元 (main.ts) がパスを解決して渡す設計。
 
 import { promises as fs } from "node:fs";
@@ -78,6 +79,33 @@ export function getCategoryForSkill(skillName: string): SkillCategory | null {
   return null;
 }
 
+export function getSkillMarkdownPath(harnessRoot: string, skillName: string): string {
+  return join(harnessRoot, SKILLS_SOURCE_DIR, skillName, "SKILL.md");
+}
+
+export async function listAvailableSkillNames(harnessRoot: string): Promise<string[]> {
+  const skillsRoot = join(harnessRoot, SKILLS_SOURCE_DIR);
+  let entries;
+  try {
+    entries = await fs.readdir(skillsRoot, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  const skills: string[] = [];
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    try {
+      await fs.access(getSkillMarkdownPath(harnessRoot, entry.name));
+      skills.push(entry.name);
+    } catch {
+      // Directories without SKILL.md are not catalog entries.
+    }
+  }
+
+  return skills.sort();
+}
+
 export interface DeployResult {
   deployedSkills: string[];
   targetDir: string;