superskill 0.2.0

package/dist/integration/vault-lifecycle.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir } from "fs/promises";
+import { join } from "path";
+import { createTestContext } from "../test-helpers.js";
+import { readCommand, listCommand } from "../commands/read.js";
+import { writeCommand } from "../commands/write.js";
+import { searchCommand } from "../commands/search.js";
+import { contextCommand } from "../commands/context.js";
+import { decideCommand } from "../commands/decide.js";
+import { taskCommand } from "../commands/task.js";
+import { learnCommand } from "../commands/learn.js";
+import { parseFrontmatter } from "../lib/frontmatter.js";
+describe("integration > vault lifecycle", () => {
+    let ctx;
+    let vaultRoot;
+    let cleanup;
+    beforeEach(async () => {
+        const tc = await createTestContext({ project: "my-project" });
+        ctx = tc.ctx;
+        vaultRoot = tc.vaultRoot;
+        cleanup = tc.cleanup;
+        await mkdir(join(vaultRoot, "projects/my-project/decisions"), { recursive: true });
+        await mkdir(join(vaultRoot, "projects/my-project/tasks"), { recursive: true });
+        await mkdir(join(vaultRoot, "projects/my-project/learnings"), { recursive: true });
+    });
+    afterEach(async () => {
+        await cleanup();
+    });
+    describe("read + write round-trip", () => {
+        it("write then read returns the same content", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "# Hello\n\nWorld" }, ctx);
+            const result = await readCommand({ path: "projects/my-project/context.md" }, ctx);
+            expect(result).toContain("# Hello");
+            expect(result).toContain("World");
+        });
+        it("write with append mode appends to existing file", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "First line" }, ctx);
+            await writeCommand({ path: "projects/my-project/context.md", content: "Second line", mode: "append" }, ctx);
+            const result = await readCommand({ path: "projects/my-project/context.md" }, ctx);
+            expect(result).toContain("First line");
+            expect(result).toContain("Second line");
+            expect(result.indexOf("Second line")).toBeGreaterThan(result.indexOf("First line"));
+        });
+        it("write with prepend mode prepends before existing body", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "Original body" }, ctx);
+            await writeCommand({ path: "projects/my-project/context.md", content: "New section", mode: "prepend" }, ctx);
+            const result = await readCommand({ path: "projects/my-project/context.md" }, ctx);
+            expect(result).toContain("New section");
+            expect(result).toContain("Original body");
+            expect(result.indexOf("New section")).toBeLessThan(result.indexOf("Original body"));
+        });
+        it("write with overwrite mode replaces entire file", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "Old content" }, ctx);
+            await writeCommand({ path: "projects/my-project/context.md", content: "New content", mode: "overwrite" }, ctx);
+            const result = await readCommand({ path: "projects/my-project/context.md" }, ctx);
+            expect(result).toContain("New content");
+            expect(result).not.toContain("Old content");
+        });
+        it("write with frontmatter creates valid YAML frontmatter", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "# Context\n\nSome info", frontmatter: { type: "context", project: "my-project" } }, ctx);
+            const result = await readCommand({ path: "projects/my-project/context.md" }, ctx);
+            const { data, content } = parseFrontmatter(result);
+            expect(data.type).toBe("context");
+            expect(data.project).toBe("my-project");
+            expect(content).toContain("# Context");
+        });
+        it("list returns directory contents at depth 1 and 2", async () => {
+            await writeCommand({ path: "projects/my-project/note1.md", content: "a" }, ctx);
+            await writeCommand({ path: "projects/my-project/sub/note2.md", content: "b" }, ctx);
+            const depth1 = await listCommand({ path: "projects/my-project", depth: 1 }, ctx);
+            expect(depth1).toContain("projects/my-project/note1.md");
+            expect(depth1.some((f) => f.includes("note2.md"))).toBe(false);
+            const depth2 = await listCommand({ path: "projects/my-project", depth: 2 }, ctx);
+            expect(depth2).toContain("projects/my-project/note1.md");
+            expect(depth2.some((f) => f.includes("note2.md"))).toBe(true);
+        });
+    });
+    describe("search", () => {
+        it("text search finds written content across files", async () => {
+            await writeCommand({ path: "projects/my-project/a.md", content: "unique-needle-alpha" }, ctx);
+            await writeCommand({ path: "projects/my-project/b.md", content: "unique-needle-beta" }, ctx);
+            const results = await searchCommand({ query: "unique-needle" }, ctx);
+            expect(results.length).toBeGreaterThanOrEqual(2);
+            const paths = results.map((r) => r.path);
+            expect(paths.some((p) => p.includes("a.md"))).toBe(true);
+            expect(paths.some((p) => p.includes("b.md"))).toBe(true);
+        });
+        it("structured search filters by frontmatter fields", async () => {
+            await writeCommand({ path: "projects/my-project/s1.md", content: "doc", frontmatter: { type: "adr", project: "my-project" } }, ctx);
+            await writeCommand({ path: "projects/my-project/s2.md", content: "doc", frontmatter: { type: "task", project: "my-project" } }, ctx);
+            const results = await searchCommand({ query: "type:adr project:my-project", structured: true }, ctx);
+            expect(results.length).toBeGreaterThanOrEqual(1);
+            for (const r of results) {
+                expect(r.path).toContain("s1.md");
+            }
+        });
+        it("search with project path filter narrows results", async () => {
+            await writeCommand({ path: "projects/my-project/x.md", content: "pfx-target" }, ctx);
+            await writeCommand({ path: "other/note.md", content: "pfx-target" }, ctx);
+            const results = await searchCommand({ query: "pfx-target", project: "my-project" }, ctx);
+            expect(results.length).toBeGreaterThanOrEqual(1);
+            for (const r of results) {
+                expect(r.path).toContain("my-project");
+            }
+            expect(results.some((r) => r.path.includes("other/"))).toBe(false);
+        });
+        it("search returns empty for no matches", async () => {
+            await writeCommand({ path: "projects/my-project/z.md", content: "existing content" }, ctx);
+            const results = await searchCommand({ query: "zzz-nonexistent-xyzzy" }, ctx);
+            expect(results).toHaveLength(0);
+        });
+    });
+    describe("context", () => {
+        it("context command returns project context after writing context.md", async () => {
+            await writeCommand({ path: "projects/my-project/context.md", content: "# Overview\n\n## Architecture\n\nUses TypeScript", frontmatter: { type: "context" } }, ctx);
+            const result = await contextCommand({ project: "my-project" }, ctx);
+            expect(result.project_slug).toBe("my-project");
+            expect(result.context_md).toContain("Overview");
+            expect(result.sections).toContain("Architecture");
+        });
+        it("context with detailLevel full returns untruncated content", async () => {
+            const longContent = "A".repeat(5000);
+            await writeCommand({ path: "projects/my-project/context.md", content: longContent, frontmatter: { type: "context" } }, ctx);
+            const result = await contextCommand({ project: "my-project", detailLevel: "full" }, ctx);
+            expect(result.truncated).toBe(false);
+            expect(result.context_md).toContain(longContent.trim());
+        });
+        it("context with detailLevel summary truncates to token budget", async () => {
+            const longContent = "word ".repeat(3000);
+            await writeCommand({ path: "projects/my-project/context.md", content: longContent, frontmatter: { type: "context" } }, ctx);
+            const result = await contextCommand({ project: "my-project", detailLevel: "summary", maxTokens: 100 }, ctx);
+            expect(result.truncated).toBe(true);
+            expect(result.token_estimate).toBeLessThanOrEqual(150);
+        });
+    });
+    describe("cross-command flow", () => {
+        it("write ADR via decide, then search finds it by content", async () => {
+            const decision = await decideCommand({
+                title: "Use TypeScript",
+                context: "Need type safety",
+                decision: "We chose TypeScript",
+                project: "my-project",
+            }, ctx);
+            expect(decision.decision_number).toBe(1);
+            expect(decision.path).toContain("decisions");
+            const results = await searchCommand({ query: "TypeScript", project: "my-project" }, ctx);
+            expect(results.length).toBeGreaterThanOrEqual(1);
+            const paths = results.map((r) => r.path);
+            expect(paths.some((p) => p.includes(decision.path))).toBe(true);
+        });
+        it("write task via task, then read retrieves it", async () => {
+            const taskResult = await taskCommand({
+                action: "add",
+                title: "Implement feature X",
+                project: "my-project",
+            }, ctx);
+            expect(taskResult.task_id).toBe("task-001");
+            expect(taskResult.path).toBeDefined();
+            const content = await readCommand({ path: taskResult.path }, ctx);
+            expect(content).toContain("Implement feature X");
+            const { data } = parseFrontmatter(content);
+            expect(data.type).toBe("task");
+            expect(data.status).toBe("backlog");
+        });
+        it("write learning, then context includes learning count", async () => {
+            await learnCommand({
+                action: "add",
+                title: "Vault is fast",
+                discovery: "File operations complete in under 1ms",
+                project: "my-project",
+            }, ctx);
+            await learnCommand({
+                action: "add",
+                title: "Frontmatter matters",
+                discovery: "YAML frontmatter enables structured search",
+                project: "my-project",
+            }, ctx);
+            const result = await contextCommand({ project: "my-project" }, ctx);
+            expect(result.learning_count).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=vault-lifecycle.test.js.map

package/dist/integration/vault-lifecycle.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault-lifecycle.test.js","sourceRoot":"","sources":["../../src/integration/vault-lifecycle.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/auto-number.d.ts

@@ -0,0 +1,10 @@
+import { VaultFS } from "./vault-fs.js";
+/**
+ * Find the next auto-increment number for files in a directory.
+ * Scans existing files matching NNN-*.md pattern.
+ */
+export declare function getNextNumber(vaultFs: VaultFS, dirPath: string): Promise<number>;
+/**
+ * Generate a filename slug from a title.
+ */
+export declare function slugify(title: string): string;

package/dist/lib/auto-number.js

@@ -0,0 +1,33 @@
+/**
+ * Find the next auto-increment number for files in a directory.
+ * Scans existing files matching NNN-*.md pattern.
+ */
+export async function getNextNumber(vaultFs, dirPath) {
+    let nextNumber = 1;
+    try {
+        const files = await vaultFs.list(dirPath, 1);
+        for (const file of files) {
+            const match = file.match(/(\d+)-/);
+            if (match) {
+                const num = parseInt(match[1], 10);
+                if (num >= nextNumber)
+                    nextNumber = num + 1;
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist yet, start at 1
+    }
+    return nextNumber;
+}
+/**
+ * Generate a filename slug from a title.
+ */
+export function slugify(title) {
+    const result = title
+        .toLowerCase()
+        .replace(/[^a-z0-9_]+/g, "-")
+        .replace(/^-|-$/g, "");
+    return result || "untitled";
+}
+//# sourceMappingURL=auto-number.js.map

package/dist/lib/auto-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-number.js","sourceRoot":"","sources":["../../src/lib/auto-number.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAgB,EAAE,OAAe;IACnE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnC,IAAI,GAAG,IAAI,UAAU;oBAAE,UAAU,GAAG,GAAG,GAAG,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,MAAM,GAAG,KAAK;SACjB,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,MAAM,IAAI,UAAU,CAAC;AAC9B,CAAC"}

package/dist/lib/auto-number.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/auto-number.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { getNextNumber, slugify } from "./auto-number.js";
+import { VaultFS } from "./vault-fs.js";
+describe("auto-number", () => {
+    let vaultRoot;
+    let vaultFs;
+    beforeEach(async () => {
+        vaultRoot = join(tmpdir(), `autonumber-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+        vaultFs = new VaultFS(vaultRoot);
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("getNextNumber", () => {
+        it("returns 1 for empty directory", async () => {
+            await mkdir(join(vaultRoot, "empty"), { recursive: true });
+            const result = await getNextNumber(vaultFs, "empty");
+            expect(result).toBe(1);
+        });
+        it("returns 1 for non-existent directory", async () => {
+            const result = await getNextNumber(vaultFs, "nonexistent");
+            expect(result).toBe(1);
+        });
+        it("returns next number after existing files", async () => {
+            await vaultFs.write("decisions/.keep", "");
+            await vaultFs.write("decisions/001-first.md", "");
+            await vaultFs.write("decisions/002-second.md", "");
+            const result = await getNextNumber(vaultFs, "decisions");
+            expect(result).toBe(3);
+        });
+        it("handles gaps in numbering", async () => {
+            await vaultFs.write("tasks/.keep", "");
+            await vaultFs.write("tasks/001-first.md", "");
+            await vaultFs.write("tasks/005-fifth.md", "");
+            const result = await getNextNumber(vaultFs, "tasks");
+            expect(result).toBe(6);
+        });
+        it("ignores files without number prefix", async () => {
+            await vaultFs.write("mixed/.keep", "");
+            await vaultFs.write("mixed/001-numbered.md", "");
+            await vaultFs.write("mixed/unnumbered.md", "");
+            await vaultFs.write("mixed/README.md", "");
+            const result = await getNextNumber(vaultFs, "mixed");
+            expect(result).toBe(2);
+        });
+        it("handles single digit numbers", async () => {
+            await vaultFs.write("single/.keep", "");
+            await vaultFs.write("single/1-first.md", "");
+            await vaultFs.write("single/5-fifth.md", "");
+            const result = await getNextNumber(vaultFs, "single");
+            expect(result).toBe(6);
+        });
+        it("handles three digit numbers", async () => {
+            await vaultFs.write("triple/.keep", "");
+            await vaultFs.write("triple/099-late.md", "");
+            await vaultFs.write("triple/100-hundred.md", "");
+            const result = await getNextNumber(vaultFs, "triple");
+            expect(result).toBe(101);
+        });
+    });
+    describe("slugify", () => {
+        const cases = [
+            { name: "simple title", input: "Hello World", expected: "hello-world" },
+            { name: "spaces become dashes", input: "multiple   spaces", expected: "multiple-spaces" },
+            { name: "special chars removed", input: "Hello! @World# $Test%", expected: "hello-world-test" },
+            { name: "uppercase to lowercase", input: "UPPERCASE TITLE", expected: "uppercase-title" },
+            { name: "mixed case", input: "MixedCase Title", expected: "mixedcase-title" },
+            { name: "numbers preserved", input: "Task 123 Test", expected: "task-123-test" },
+            { name: "dashes at start removed", input: "-start with dash", expected: "start-with-dash" },
+            { name: "dashes at end removed", input: "end with dash-", expected: "end-with-dash" },
+            { name: "multiple dashes collapsed", input: "a---b", expected: "a-b" },
+            { name: "empty string", input: "", expected: "untitled" },
+            { name: "only special chars", input: "!@#$%", expected: "untitled" },
+            { name: "underscore preserved", input: "hello_world", expected: "hello_world" },
+            { name: "dots removed", input: "file.name.md", expected: "file-name-md" },
+        ];
+        for (const c of cases) {
+            it(c.name, () => {
+                expect(slugify(c.input)).toBe(c.expected);
+            });
+        }
+    });
+});
+//# sourceMappingURL=auto-number.test.js.map

package/dist/lib/auto-number.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-number.test.js","sourceRoot":"","sources":["../../src/lib/auto-number.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/auto-profile.d.ts

@@ -0,0 +1,11 @@
+import type { DetectedStack } from "./stack-detector.js";
+import type { DetectedTool } from "./tool-detector.js";
+export declare function getRelevantDomains(stack: DetectedStack): string[];
+export interface AutoConfig {
+    profile: string;
+    size: 'compact' | 'standard' | 'full';
+    reason: string;
+    detectedStack: DetectedStack;
+    detectedTool: DetectedTool;
+}
+export declare function autoDetect(projectPath?: string): Promise<AutoConfig>;

package/dist/lib/auto-profile.js

@@ -0,0 +1,123 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later OR Commercial
+import { detectStack } from "./stack-detector.js";
+import { detectTool } from "./tool-detector.js";
+// All known domains from the catalog
+const ALL_DOMAINS = [
+    "tdd", "planning", "code-review", "verification", "agent-orchestration",
+    "security", "shipping", "debugging", "brainstorming", "frontend-design",
+    "3d-animation", "meta", "go", "python", "django", "spring-boot", "swift",
+    "cpp", "java", "database", "git-workflow", "api-design", "backend-patterns",
+    "agent-engineering", "content-business", "docker", "frontend-patterns",
+    "coding-standards",
+];
+// Base domains that are always included
+const BASE_DOMAINS = [
+    "tdd", "code-review", "verification", "planning", "security", "debugging",
+    "meta", "git-workflow", "agent-orchestration", "agent-engineering",
+    "brainstorming", "shipping",
+];
+export function getRelevantDomains(stack) {
+    const { languages, frameworks, primary } = stack;
+    // No specific stack detected → return all domains (no filtering)
+    if (primary === "unknown" && languages.length === 0 && frameworks.length === 0) {
+        return [...ALL_DOMAINS];
+    }
+    const domains = new Set(BASE_DOMAINS);
+    // Go detected
+    if (languages.includes("go") || primary === "go") {
+        domains.add("go");
+        domains.add("api-design");
+        domains.add("backend-patterns");
+    }
+    // Python detected
+    if (languages.includes("python") || primary === "python") {
+        domains.add("python");
+    }
+    // Django detected
+    if (frameworks.includes("django")) {
+        domains.add("django");
+        domains.add("database");
+    }
+    // Spring Boot detected
+    if (frameworks.includes("spring-boot")) {
+        domains.add("spring-boot");
+        domains.add("java");
+        domains.add("database");
+    }
+    // Frontend frameworks detected
+    const frontendFrameworks = ["react", "next", "vue", "angular"];
+    const hasFrontend = frontendFrameworks.some((fw) => frameworks.includes(fw));
+    if (hasFrontend) {
+        domains.add("frontend-design");
+        domains.add("3d-animation");
+    }
+    // Swift detected
+    if (languages.includes("swift") || primary === "swift") {
+        domains.add("swift");
+    }
+    // C++ detected
+    if (languages.includes("cpp") || primary === "cpp") {
+        domains.add("cpp");
+    }
+    // Java detected (non-Spring)
+    if ((languages.includes("java") || primary === "java") && !frameworks.includes("spring-boot")) {
+        domains.add("java");
+    }
+    // content-business: only when no specific tech stack detected
+    const hasSpecificStack = languages.length > 0 && primary !== "unknown";
+    if (!hasSpecificStack) {
+        domains.add("content-business");
+    }
+    return [...domains];
+}
+function selectProfile(stack) {
+    const { languages, frameworks, primary } = stack;
+    // Framework-specific overrides
+    if (frameworks.includes("django") || frameworks.includes("spring-boot")) {
+        return "ecc-first";
+    }
+    // Primary language selection
+    if (primary === "go" || primary === "python") {
+        return "ecc-first";
+    }
+    // TypeScript/JavaScript with React
+    if ((languages.includes("typescript") || languages.includes("javascript")) &&
+        frameworks.includes("react")) {
+        return "ecc-first";
+    }
+    // Any other known language → ecc-first (ECC has broad language support)
+    if (primary !== "unknown" && languages.length > 0) {
+        return "ecc-first";
+    }
+    // Unknown / mixed / no recognisable stack → methodology-focused
+    return "superpowers-first";
+}
+function selectSize(contextWindow) {
+    const ctx = contextWindow ?? 128_000;
+    if (ctx >= 500_000)
+        return "full";
+    if (ctx >= 100_000)
+        return "standard";
+    return "compact";
+}
+function buildReason(stack, tool, profile, size) {
+    const stackDesc = stack.primary !== "unknown"
+        ? [stack.primary, ...stack.frameworks].join(" + ")
+        : "unknown stack";
+    const toolDesc = tool.tool !== "unknown"
+        ? `${tool.tool}${tool.model ? ` (${tool.model})` : ""}`
+        : "unknown tool";
+    return `${stackDesc} project on ${toolDesc} → ${profile}, ${size}`;
+}
+export async function autoDetect(projectPath) {
+    const cwd = projectPath ?? process.cwd();
+    const [detectedStack, detectedTool] = await Promise.all([
+        detectStack(cwd),
+        Promise.resolve(detectTool()),
+    ]);
+    const profile = selectProfile(detectedStack);
+    const size = selectSize(detectedTool.contextWindow);
+    const reason = buildReason(detectedStack, detectedTool, profile, size);
+    return { profile, size, reason, detectedStack, detectedTool };
+}
+//# sourceMappingURL=auto-profile.js.map

package/dist/lib/auto-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-profile.js","sourceRoot":"","sources":["../../src/lib/auto-profile.ts"],"names":[],"mappings":"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"}

package/dist/lib/auto-profile.test.d.ts

@@ -0,0 +1 @@
+export {};