@shepai/cli 1.59.0 → 1.61.0

package/dist/src/presentation/web/hooks/use-sound-action.stories.js

@@ -0,0 +1,61 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useState } from 'react';
+import { Button } from '../components/ui/button.js';
+import { useSoundAction, SOUND_ACTION_MAP } from './use-sound-action.js';
+/* ------------------------------------------------------------------ */
+/*  Action categories for display grouping                            */
+/* ------------------------------------------------------------------ */
+const ACTION_CATEGORIES = {
+    'Navigation (0.2)': ['navigate', 'menu-item'],
+    'Toggles & Selections (0.3)': [
+        'select',
+        'toggle-on',
+        'toggle-off',
+        'click',
+        'cancel',
+        'expand',
+        'collapse',
+        'menu-open',
+        'copy',
+    ],
+    'Drawers & Transitions (0.4)': ['drawer-open', 'drawer-close', 'submit'],
+    'Significant Actions (0.5)': ['approve', 'reject', 'create', 'delete'],
+    'Notifications (0.5)': [
+        'notification-success',
+        'notification-error',
+        'notification-warning',
+        'notification-info',
+    ],
+};
+/* ------------------------------------------------------------------ */
+/*  Single action button                                              */
+/* ------------------------------------------------------------------ */
+function ActionSoundButton({ action }) {
+    const { play } = useSoundAction(action);
+    const [playing, setPlaying] = useState(false);
+    const entry = SOUND_ACTION_MAP[action];
+    const handleClick = () => {
+        play();
+        setPlaying(true);
+        setTimeout(() => setPlaying(false), 600);
+    };
+    return (_jsxs(Button, { size: "sm", variant: playing ? 'default' : 'outline', onClick: handleClick, className: "min-w-[160px] font-mono text-xs", children: [action, _jsxs("span", { className: "text-muted-foreground ml-1 text-[10px]", children: ["(", entry.sound, " @ ", entry.volume, ")"] })] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Full catalog                                                      */
+/* ------------------------------------------------------------------ */
+function SoundActionCatalog() {
+    return (_jsxs("div", { className: "flex w-[640px] flex-col gap-6", children: [_jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("h2", { className: "text-base font-semibold", children: "Sound Action Map" }), _jsxs("p", { className: "text-muted-foreground text-sm", children: [Object.keys(SOUND_ACTION_MAP).length, " semantic actions mapped to sounds. Volume hierarchy: navigation (0.2) \u2192 toggles (0.3) \u2192 drawers (0.4) \u2192 actions (0.5)."] })] }), Object.entries(ACTION_CATEGORIES).map(([category, actions]) => (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h3", { className: "text-sm font-semibold", children: category }), _jsx("div", { className: "flex flex-wrap gap-2", children: actions.map((action) => (_jsx(ActionSoundButton, { action: action }, action))) })] }, category)))] }));
+}
+/* ------------------------------------------------------------------ */
+/*  Storybook meta                                                    */
+/* ------------------------------------------------------------------ */
+const meta = {
+    title: 'Hooks/useSoundAction',
+    parameters: { layout: 'centered' },
+    tags: ['autodocs'],
+};
+export default meta;
+export const Catalog = {
+    render: () => _jsx(SoundActionCatalog, {}),
+};

package/dist/src/presentation/web/lib/feature-flags.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Feature flags for the web UI.
+ *
+ * Toggle via environment variables (NEXT_PUBLIC_ prefix for client access).
+ * All flags default to **off** unless explicitly set to "true" or "1".
+ */
+export declare const featureFlags: {
+    readonly skills: boolean;
+};
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/src/presentation/web/lib/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,YAAY;;CAEf,CAAC"}

package/dist/src/presentation/web/lib/feature-flags.js

@@ -0,0 +1,12 @@
+/**
+ * Feature flags for the web UI.
+ *
+ * Toggle via environment variables (NEXT_PUBLIC_ prefix for client access).
+ * All flags default to **off** unless explicitly set to "true" or "1".
+ */
+function isEnabled(envVar) {
+    return envVar === 'true' || envVar === '1';
+}
+export const featureFlags = {
+    skills: isEnabled(process.env.NEXT_PUBLIC_FLAG_SKILLS),
+};

package/dist/src/presentation/web/lib/skills.d.ts

@@ -0,0 +1,30 @@
+export type SkillCategory = 'Workflow' | 'Code Generation' | 'Analysis' | 'Reference';
+export type SkillSource = 'project' | 'global';
+export interface SkillResource {
+    name: string;
+    fileCount: number;
+}
+export interface SkillData {
+    name: string;
+    displayName: string;
+    description: string;
+    context?: string;
+    allowedTools?: string;
+    category: SkillCategory;
+    source: SkillSource;
+    body: string;
+    resources: SkillResource[];
+}
+export declare function deriveCategory(name: string): SkillCategory;
+export declare function getDisplayName(name: string): string;
+interface FrontmatterResult {
+    name: string;
+    description: string;
+    context?: string;
+    allowedTools?: string;
+    body: string;
+}
+export declare function parseFrontmatter(content: string): FrontmatterResult | null;
+export declare function getSkills(projectRoot?: string, homeDir?: string): Promise<SkillData[]>;
+export {};
+//# sourceMappingURL=skills.d.ts.map

package/dist/src/presentation/web/lib/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/web/lib/skills.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AACtF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAUD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAK1D;AAMD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAID,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiC1E;AA0ED,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAiB5F"}

package/dist/src/presentation/web/lib/skills.js

@@ -0,0 +1,137 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import yaml from 'js-yaml';
+// ── Category Derivation ──────────────────────────────────────────────────────
+const CATEGORY_RULES = [
+    { test: (name) => name.startsWith('shep-kit:'), category: 'Workflow' },
+    { test: (name) => name.startsWith('shep:'), category: 'Code Generation' },
+    { test: (name) => /(?:review|validate|cross-validate)/.test(name), category: 'Analysis' },
+];
+export function deriveCategory(name) {
+    for (const rule of CATEGORY_RULES) {
+        if (rule.test(name))
+            return rule.category;
+    }
+    return 'Reference';
+}
+// ── Display Name ─────────────────────────────────────────────────────────────
+const DISPLAY_NAME_PREFIXES = ['shep-kit:', 'shep:'];
+export function getDisplayName(name) {
+    for (const prefix of DISPLAY_NAME_PREFIXES) {
+        if (name.startsWith(prefix))
+            return name.slice(prefix.length);
+    }
+    return name;
+}
+export function parseFrontmatter(content) {
+    const delimiterPattern = /^---\s*$/m;
+    const firstMatch = content.match(delimiterPattern);
+    if (firstMatch?.index === undefined)
+        return null;
+    const afterFirst = firstMatch.index + firstMatch[0].length;
+    const rest = content.slice(afterFirst);
+    const secondMatch = rest.match(delimiterPattern);
+    if (secondMatch?.index === undefined)
+        return null;
+    const yamlContent = rest.slice(0, secondMatch.index);
+    const body = rest.slice(secondMatch.index + secondMatch[0].length).trim();
+    let parsed;
+    try {
+        parsed = yaml.load(yamlContent);
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== 'object')
+        return null;
+    const name = parsed['name'];
+    const description = parsed['description'];
+    if (typeof name !== 'string' || typeof description !== 'string')
+        return null;
+    return {
+        name,
+        description,
+        context: typeof parsed['context'] === 'string' ? parsed['context'] : undefined,
+        allowedTools: typeof parsed['allowed-tools'] === 'string' ? parsed['allowed-tools'] : undefined,
+        body,
+    };
+}
+// ── Resource Detection ───────────────────────────────────────────────────────
+const KNOWN_RESOURCE_DIRS = [
+    'references',
+    'examples',
+    'templates',
+    'scripts',
+    'validation',
+    'rules',
+];
+async function detectResources(skillDir) {
+    const resources = [];
+    for (const dirName of KNOWN_RESOURCE_DIRS) {
+        try {
+            const entries = await readdir(join(skillDir, dirName));
+            resources.push({ name: dirName, fileCount: entries.length });
+        }
+        catch {
+            // Directory doesn't exist — skip
+        }
+    }
+    return resources;
+}
+// ── Skill Directory Reader ───────────────────────────────────────────────────
+async function getSkillsFromDirectory(dirPath, source) {
+    let entries;
+    try {
+        const dirEntries = await readdir(dirPath, { withFileTypes: true });
+        entries = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+    const skills = [];
+    for (const entry of entries) {
+        const skillDir = join(dirPath, entry);
+        const skillMdPath = join(skillDir, 'SKILL.md');
+        let content;
+        try {
+            content = await readFile(skillMdPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const frontmatter = parseFrontmatter(content);
+        if (!frontmatter) {
+            // eslint-disable-next-line no-console
+            console.warn(`Skipping skill "${entry}": invalid or missing frontmatter in SKILL.md`);
+            continue;
+        }
+        const resources = await detectResources(skillDir);
+        skills.push({
+            name: frontmatter.name,
+            displayName: getDisplayName(frontmatter.name),
+            description: frontmatter.description,
+            context: frontmatter.context,
+            allowedTools: frontmatter.allowedTools,
+            category: deriveCategory(frontmatter.name),
+            source,
+            body: frontmatter.body,
+            resources,
+        });
+    }
+    return skills;
+}
+export async function getSkills(projectRoot, homeDir) {
+    const root = projectRoot ?? process.cwd();
+    const home = homeDir ?? homedir();
+    const projectDir = join(root, '.claude', 'skills');
+    const globalDir = join(home, '.claude', 'skills');
+    const [projectSkills, globalSkills] = await Promise.all([
+        getSkillsFromDirectory(projectDir, 'project'),
+        getSkillsFromDirectory(globalDir, 'global'),
+    ]);
+    // Deduplicate by name — project skills take precedence over global skills
+    const seen = new Set(projectSkills.map((s) => s.name));
+    const uniqueGlobalSkills = globalSkills.filter((s) => !seen.has(s.name));
+    return [...projectSkills, ...uniqueGlobalSkills].sort((a, b) => a.name.localeCompare(b.name));
+}