clavix 5.6.2 → 5.6.3

package/dist/config/integrations.json

@@ -1,6 +1,6 @@
 {
   "$schema": "./integrations.schema.json",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "integrations": [
     {
       "name": "cursor",
@@ -9,7 +9,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".cursor"
+      "detection": ".cursor",
+      "type": "standard"
     },
     {
       "name": "windsurf",
@@ -18,7 +19,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".windsurf"
+      "detection": ".windsurf",
+      "type": "standard"
     },
     {
       "name": "kilocode",
@@ -27,7 +29,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".kilocode"
+      "detection": ".kilocode",
+      "type": "standard"
     },
     {
       "name": "roocode",
@@ -36,7 +39,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".roo"
+      "detection": ".roo",
+      "type": "standard"
     },
     {
       "name": "cline",
@@ -45,7 +49,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".clinerules"
+      "detection": ".clinerules",
+      "type": "standard"
     },
     {
       "name": "droid",
@@ -55,7 +60,8 @@
       "extension": ".md",
       "separator": "-",
       "detection": ".factory",
-      "placeholder": "$ARGUMENTS"
+      "placeholder": "$ARGUMENTS",
+      "type": "standard"
     },
     {
       "name": "opencode",
@@ -65,7 +71,8 @@
       "extension": ".md",
       "separator": "-",
       "detection": ".opencode",
-      "placeholder": "$ARGUMENTS"
+      "placeholder": "$ARGUMENTS",
+      "type": "standard"
     },
     {
       "name": "codebuddy",
@@ -74,7 +81,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".codebuddy"
+      "detection": ".codebuddy",
+      "type": "standard"
     },
     {
       "name": "amp",
@@ -83,7 +91,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".agents"
+      "detection": ".agents",
+      "type": "standard"
     },
     {
       "name": "crush",
@@ -92,7 +101,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".crush"
+      "detection": ".crush",
+      "type": "standard"
     },
     {
       "name": "codex",
@@ -103,7 +113,8 @@
       "separator": "-",
       "detection": ".codex",
       "global": true,
-      "placeholder": "$ARGUMENTS"
+      "placeholder": "$ARGUMENTS",
+      "type": "standard"
     },
     {
       "name": "augment",
@@ -112,7 +123,8 @@
       "filenamePattern": "clavix-{name}",
       "extension": ".md",
       "separator": "-",
-      "detection": ".augment"
+      "detection": ".augment",
+      "type": "standard"
     },
     {
       "name": "claude-code",
@@ -122,7 +134,8 @@
       "extension": ".md",
       "separator": ":",
       "detection": ".claude",
-      "specialAdapter": "doc-injection"
+      "specialAdapter": "doc-injection",
+      "type": "standard"
     },
     {
       "name": "gemini",
@@ -133,7 +146,8 @@
       "separator": ":",
       "detection": ".gemini",
       "specialAdapter": "toml",
-      "rootDir": ".gemini"
+      "rootDir": ".gemini",
+      "type": "standard"
     },
     {
       "name": "qwen",
@@ -144,7 +158,8 @@
       "separator": ":",
       "detection": ".qwen",
       "specialAdapter": "toml",
-      "rootDir": ".qwen"
+      "rootDir": ".qwen",
+      "type": "standard"
     },
     {
       "name": "llxprt",
@@ -155,7 +170,48 @@
       "separator": ":",
       "detection": ".llxprt",
       "specialAdapter": "toml",
-      "rootDir": ".llxprt"
+      "rootDir": ".llxprt",
+      "type": "standard"
+    },
+    {
+      "name": "agents-md",
+      "displayName": "AGENTS.md",
+      "directory": ".",
+      "filenamePattern": "AGENTS",
+      "extension": ".md",
+      "separator": "-",
+      "detection": "AGENTS.md",
+      "type": "universal"
+    },
+    {
+      "name": "copilot-instructions",
+      "displayName": "GitHub Copilot",
+      "directory": ".github",
+      "filenamePattern": "copilot-instructions",
+      "extension": ".md",
+      "separator": "-",
+      "detection": ".github",
+      "type": "universal"
+    },
+    {
+      "name": "octo-md",
+      "displayName": "OCTO.md (Octofriend)",
+      "directory": ".",
+      "filenamePattern": "OCTO",
+      "extension": ".md",
+      "separator": "-",
+      "detection": "OCTO.md",
+      "type": "universal"
+    },
+    {
+      "name": "warp-md",
+      "displayName": "WARP.md (Warp AI)",
+      "directory": ".",
+      "filenamePattern": "WARP",
+      "extension": ".md",
+      "separator": "-",
+      "detection": "WARP.md",
+      "type": "universal"
     }
   ]
 }

package/dist/core/adapter-registry.js

@@ -17,9 +17,21 @@
  */
 import { createRequire } from 'module';
 import { DEFAULT_MD_FEATURES, DEFAULT_TOML_FEATURES, } from '../types/adapter-config.js';
+import { validateIntegrationsConfig, formatZodErrors, } from '../utils/schemas.js';
 // Use createRequire for JSON imports in ESM
 const require = createRequire(import.meta.url);
-const integrations = require('../config/integrations.json');
+const rawIntegrations = require('../config/integrations.json');
+// Validate integrations.json at load time (build-time validation)
+const validationResult = validateIntegrationsConfig(rawIntegrations);
+if (!validationResult.success && validationResult.errors) {
+    const errorMessages = formatZodErrors(validationResult.errors);
+    throw new Error(`Invalid integrations.json configuration:\n${errorMessages.map((e) => `  - ${e}`).join('\n')}`);
+}
+// Log warnings for unknown fields (non-blocking)
+if (validationResult.warnings && validationResult.warnings.length > 0) {
+    console.warn(`[Clavix] integrations.json warnings:\n${validationResult.warnings.map((w) => `  - ${w}`).join('\n')}`);
+}
+const integrations = validationResult.data;
 /**
  * Transform JSON config to AdapterConfig
  */

package/dist/templates/slash-commands/_canonical/implement.md

@@ -27,14 +27,38 @@ When you run `/clavix:implement`, I:
 ```
 /clavix:implement
     │
-    ├─► Check .clavix/outputs/<project>/tasks.md
+    ├─► Check .clavix/outputs/<project>/tasks.md (all project folders)
     │       └─► If found → Task Implementation Mode
     │
+    ├─► Check .clavix/outputs/summarize/tasks.md (legacy fallback)
+    │       └─► If found → Task Implementation Mode (legacy)
+    │
     └─► Check .clavix/outputs/prompts/*.md
             └─► If found → Prompt Execution Mode
             └─► If neither → Ask what to build
 ```
 
+### Required Confirmation Message
+
+**Before starting any implementation, you MUST output a confirmation message:**
+
+**For tasks.md detection:**
+```
+Found tasks.md with [N] pending tasks in [project-name]. Starting task implementation...
+```
+
+**For prompt detection:**
+```
+Found [N] saved prompt(s) in prompts/. Implementing [prompt-name]...
+```
+
+**For legacy summarize/ fallback:**
+```
+Found tasks.md with [N] pending tasks in summarize/ (legacy location). Starting task implementation...
+```
+
+This confirmation ensures the user knows exactly what will be implemented before any code is written.
+
 ### Explicit Flags
 
 Override auto-detection when needed:

package/dist/templates/slash-commands/_canonical/improve.md

@@ -47,7 +47,7 @@ This is a prompt improvement workflow. Your job is to ANALYZE and IMPROVE the pr
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting analysis, output:**
 ```

package/dist/templates/slash-commands/_canonical/plan.md

@@ -66,7 +66,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting task breakdown, output:**
 ```
@@ -88,10 +88,13 @@ Implementation: BLOCKED - I will create tasks, not implement them
 
 1. **Validate prerequisites**:
    - Check if `.clavix/outputs/` directory exists
-   - Look for PRD artifacts: `full-prd.md`, `quick-prd.md`, `mini-prd.md`, or `optimized-prompt.md`
+   - Look for PRD artifacts in this order:
+     1. **Project directories first**: Check `.clavix/outputs/<project-name>/` folders for `full-prd.md`, `quick-prd.md`, `mini-prd.md`, or `optimized-prompt.md`
+     2. **Legacy fallback**: If no project directories found, check `.clavix/outputs/summarize/` for `mini-prd.md` or `optimized-prompt.md` (backwards compatibility)
+   - **If multiple projects found**: List them and ask user which one to plan
    - **If not found**: Error inline - "No PRD found in `.clavix/outputs/`. Use `/clavix:prd` or `/clavix:summarize` first."
 
-2. **Read the PRD** from `.clavix/outputs/[project-name]/`
+2. **Read the PRD** from detected location (project directory or legacy `summarize/` folder)
 
 3. **Generate task breakdown** following Part B principles
 

package/dist/templates/slash-commands/_canonical/prd.md

@@ -65,7 +65,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting PRD development, output:**
 ```

package/dist/templates/slash-commands/_canonical/refine.md

@@ -68,7 +68,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting refinement, output:**
 ```

package/dist/templates/slash-commands/_canonical/start.md

@@ -65,7 +65,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting conversation, output:**
 ```

package/dist/templates/slash-commands/_canonical/summarize.md

@@ -66,7 +66,7 @@ For complete mode documentation, see: `.clavix/instructions/core/clavix-mode.md`
 
 ---
 
-## State Assertion (Required)
+## State Assertion (REQUIRED)
 
 **Before starting extraction, output:**
 ```
@@ -129,13 +129,40 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
 3. **CREATE OUTPUT FILES (REQUIRED)** - You MUST create three files. This is not optional.
 
-   **Step 3.1: Create directory structure**
+   **Step 3.1: Determine project name (Suggest + Confirm)**
+
+   Before creating files, derive a project name from the conversation:
+
+   1. **Analyze conversation** to extract a meaningful name:
+      - Look for explicit project names mentioned
+      - Identify the main topic/feature being discussed
+      - Use key nouns (e.g., "auth", "dashboard", "todo")
+
+   2. **Generate suggested name**:
+      - Format: lowercase, hyphen-separated (e.g., "user-auth", "sales-dashboard")
+      - Keep it short (2-4 words max)
+      - Make it descriptive but concise
+
+   3. **Ask user to confirm**:
+      ```
+      I'll save these requirements as project "[suggested-name]".
+
+      Is this name okay? (y/n/custom name)
+      ```
+
+   4. **Handle response**:
+      - "y" or "yes" → use suggested name
+      - "n" or "no" → ask for custom name
+      - Any other text → use that as the project name (sanitize to lowercase-hyphenated)
+
+   **Step 3.2: Create directory structure**
    ```bash
    mkdir -p .clavix/outputs/[project-name]
    ```
-   Use a meaningful project name based on the conversation (e.g., "todo-app", "auth-system", "dashboard").
 
-   **Step 3.2: Write mini-prd.md**
+   **Note (Backwards Compatibility):** Legacy workflows may have used `.clavix/outputs/summarize/` as output. The `/clavix:plan` and `/clavix:implement` commands check both project directories and the legacy `summarize/` location.
+
+   **Step 3.3: Write mini-prd.md**
 
    Use the Write tool to create `.clavix/outputs/[project-name]/mini-prd.md` with this content:
 
@@ -199,7 +226,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    **CHECKPOINT:** Created mini-prd.md successfully
 
-   **Step 3.3: Write original-prompt.md**
+   **Step 3.4: Write original-prompt.md**
 
    Use the Write tool to create `.clavix/outputs/[project-name]/original-prompt.md`
 
@@ -225,7 +252,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    **CHECKPOINT:** Created original-prompt.md successfully
 
-   **Step 3.4: Write optimized-prompt.md**
+   **Step 3.5: Write optimized-prompt.md**
 
    Use the Write tool to create `.clavix/outputs/[project-name]/optimized-prompt.md`
 
@@ -257,7 +284,7 @@ Implementation: BLOCKED - I will extract requirements, not implement them
 
    **CHECKPOINT:** Created optimized-prompt.md successfully
 
-   **Step 3.5: Verify file creation**
+   **Step 3.6: Verify file creation**
 
    List the created files to confirm they exist:
    ```

package/dist/utils/schemas.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Zod schemas for configuration file validation
+ * Provides runtime validation for integrations.json and user config.json
+ */
+import { z } from 'zod';
+/**
+ * Schema for a single integration entry in integrations.json
+ */
+export declare const IntegrationEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    directory: z.ZodString;
+    filenamePattern: z.ZodString;
+    extension: z.ZodEnum<[".md", ".toml"]>;
+    separator: z.ZodEnum<[":", "-"]>;
+    detection: z.ZodString;
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["standard", "universal"]>>>;
+    specialAdapter: z.ZodOptional<z.ZodEnum<["toml", "doc-injection"]>>;
+    rootDir: z.ZodOptional<z.ZodString>;
+    global: z.ZodOptional<z.ZodBoolean>;
+    placeholder: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    directory: string;
+    separator: ":" | "-";
+    detection: string;
+    displayName: string;
+    filenamePattern: string;
+    extension: ".md" | ".toml";
+    type: "standard" | "universal";
+    specialAdapter?: "toml" | "doc-injection" | undefined;
+    rootDir?: string | undefined;
+    global?: boolean | undefined;
+    placeholder?: string | undefined;
+}, {
+    name: string;
+    directory: string;
+    separator: ":" | "-";
+    detection: string;
+    displayName: string;
+    filenamePattern: string;
+    extension: ".md" | ".toml";
+    type?: "standard" | "universal" | undefined;
+    specialAdapter?: "toml" | "doc-injection" | undefined;
+    rootDir?: string | undefined;
+    global?: boolean | undefined;
+    placeholder?: string | undefined;
+}>;
+/**
+ * Schema for the full integrations.json file
+ */
+export declare const IntegrationsConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodString;
+    integrations: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        directory: z.ZodString;
+        filenamePattern: z.ZodString;
+        extension: z.ZodEnum<[".md", ".toml"]>;
+        separator: z.ZodEnum<[":", "-"]>;
+        detection: z.ZodString;
+        type: z.ZodDefault<z.ZodOptional<z.ZodEnum<["standard", "universal"]>>>;
+        specialAdapter: z.ZodOptional<z.ZodEnum<["toml", "doc-injection"]>>;
+        rootDir: z.ZodOptional<z.ZodString>;
+        global: z.ZodOptional<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type: "standard" | "universal";
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }, {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type?: "standard" | "universal" | undefined;
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }>, "many">, {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type: "standard" | "universal";
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }[], {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type?: "standard" | "universal" | undefined;
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }[]>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    integrations: {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type: "standard" | "universal";
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}, {
+    version: string;
+    integrations: {
+        name: string;
+        directory: string;
+        separator: ":" | "-";
+        detection: string;
+        displayName: string;
+        filenamePattern: string;
+        extension: ".md" | ".toml";
+        type?: "standard" | "universal" | undefined;
+        specialAdapter?: "toml" | "doc-injection" | undefined;
+        rootDir?: string | undefined;
+        global?: boolean | undefined;
+        placeholder?: string | undefined;
+    }[];
+    $schema?: string | undefined;
+}>;
+/**
+ * Schema for user's .clavix/config.json
+ */
+export declare const UserConfigSchema: z.ZodObject<{
+    integrations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    integrations?: string[] | undefined;
+    providers?: string[] | undefined;
+}, {
+    integrations?: string[] | undefined;
+    providers?: string[] | undefined;
+}>;
+/**
+ * Inferred TypeScript types from schemas
+ */
+export type IntegrationEntry = z.infer<typeof IntegrationEntrySchema>;
+export type IntegrationsConfig = z.infer<typeof IntegrationsConfigSchema>;
+export type UserConfig = z.infer<typeof UserConfigSchema>;
+/**
+ * Validation result type
+ */
+export interface ValidationResult<T> {
+    success: boolean;
+    data?: T;
+    errors?: z.ZodError;
+    warnings?: string[];
+}
+/**
+ * Validate integrations.json content (build-time, strict)
+ * @param content - Parsed JSON content from integrations.json
+ * @returns Validation result with parsed data or errors
+ */
+export declare function validateIntegrationsConfig(content: unknown): ValidationResult<IntegrationsConfig>;
+/**
+ * Validate user config.json content (runtime, lenient)
+ * @param content - Parsed JSON content from .clavix/config.json
+ * @returns Validation result with parsed data or errors
+ */
+export declare function validateUserConfig(content: unknown): ValidationResult<UserConfig>;
+/**
+ * Format Zod errors into human-readable messages
+ * @param errors - Zod validation errors
+ * @returns Array of formatted error messages
+ */
+export declare function formatZodErrors(errors: z.ZodError): string[];
+//# sourceMappingURL=schemas.d.ts.map