peaks-cli 1.0.11 → 1.0.13

package/dist/src/shared/json-schema-mini.js

@@ -0,0 +1,113 @@
+function joinPath(parent, segment) {
+    if (parent === '/') {
+        return `/${segment}`;
+    }
+    return `${parent}/${segment}`;
+}
+function typeOf(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    if (Number.isInteger(value)) {
+        return 'integer';
+    }
+    return typeof value;
+}
+function matchesType(value, expected) {
+    if (expected === 'integer') {
+        return typeof value === 'number' && Number.isFinite(value) && Number.isInteger(value);
+    }
+    if (expected === 'number') {
+        return typeof value === 'number' && Number.isFinite(value);
+    }
+    if (expected === 'array') {
+        return Array.isArray(value);
+    }
+    if (expected === 'null') {
+        return value === null;
+    }
+    if (expected === 'object') {
+        return value !== null && typeof value === 'object' && !Array.isArray(value);
+    }
+    return typeof value === expected;
+}
+function validateNode(value, schema, path, errors) {
+    if (Array.isArray(schema.oneOf)) {
+        const branches = schema.oneOf;
+        const branchErrors = [];
+        let matched = false;
+        for (const branch of branches) {
+            const sink = [];
+            validateNode(value, branch, path, sink);
+            if (sink.length === 0) {
+                matched = true;
+                break;
+            }
+            branchErrors.push(sink);
+        }
+        if (!matched) {
+            const detail = branchErrors.map((sink) => sink.map((issue) => issue.message).join(' / ')).join(' | ');
+            errors.push({ path, message: `does not match any oneOf branch (${detail})` });
+        }
+        return;
+    }
+    const expectedType = typeof schema.type === 'string' ? schema.type : null;
+    if (expectedType !== null && !matchesType(value, expectedType)) {
+        errors.push({ path, message: `expected type ${expectedType}, got ${typeOf(value)}` });
+        return;
+    }
+    if (typeof value === 'string') {
+        if (typeof schema.minLength === 'number' && value.length < schema.minLength) {
+            errors.push({ path, message: `string shorter than minLength ${schema.minLength}` });
+        }
+        if (typeof schema.pattern === 'string' && !new RegExp(schema.pattern).test(value)) {
+            errors.push({ path, message: `string does not match pattern ${schema.pattern}` });
+        }
+        if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+            errors.push({ path, message: `value ${JSON.stringify(value)} is not in enum` });
+        }
+        return;
+    }
+    if (typeof value === 'number') {
+        if (typeof schema.minimum === 'number' && value < schema.minimum) {
+            errors.push({ path, message: `number below minimum ${schema.minimum}` });
+        }
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (schema.items !== undefined) {
+            const itemSchema = schema.items;
+            value.forEach((entry, index) => {
+                validateNode(entry, itemSchema, joinPath(path, index), errors);
+            });
+        }
+        return;
+    }
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        if (Array.isArray(schema.required)) {
+            for (const key of schema.required) {
+                if (!Object.prototype.hasOwnProperty.call(record, key)) {
+                    errors.push({ path, message: `missing required property: ${key}` });
+                }
+            }
+        }
+        const properties = schema.properties;
+        if (properties !== null && typeof properties === 'object' && !Array.isArray(properties)) {
+            const propertyMap = properties;
+            for (const [key, child] of Object.entries(propertyMap)) {
+                if (Object.prototype.hasOwnProperty.call(record, key)) {
+                    validateNode(record[key], child, joinPath(path, key), errors);
+                }
+            }
+        }
+    }
+}
+export function validateAgainstSchema(value, schema) {
+    const errors = [];
+    validateNode(value, schema, '/', errors);
+    return { valid: errors.length === 0, errors };
+}

package/dist/src/shared/paths.d.ts

@@ -3,4 +3,4 @@ export declare const skillsDir: string;
 export declare const schemasDir: string;
 export declare const templatesDir: string;
 export declare const requiredSkillNames: readonly ["peaks-solo", "peaks-prd", "peaks-ui", "peaks-rd", "peaks-qa", "peaks-sc", "peaks-txt"];
-export declare const requiredSchemaFiles: readonly ["artifact-manifest.schema.json", "context-capsule.schema.json", "approval-record.schema.json", "change-impact.schema.json", "refactor-slice-spec.schema.json", "artifact-retention-report.schema.json", "capability-source.schema.json", "capability-item.schema.json", "capability-availability.schema.json", "recommendation-plan.schema.json", "artifact-workspace.schema.json"];
+export declare const requiredSchemaFiles: readonly ["artifact-manifest.schema.json", "context-capsule.schema.json", "approval-record.schema.json", "change-impact.schema.json", "refactor-slice-spec.schema.json", "artifact-retention-report.schema.json", "capability-source.schema.json", "capability-item.schema.json", "capability-availability.schema.json", "recommendation-plan.schema.json", "artifact-workspace.schema.json", "mcp-server.schema.json", "mcp-install-spec.schema.json", "mcp-install-plan.schema.json", "mcp-apply-result.schema.json", "openspec-change-summary.schema.json", "openspec-render-request.schema.json", "openspec-validation-result.schema.json", "doctor-report.schema.json"];

package/dist/src/shared/paths.js

@@ -36,5 +36,13 @@ export const requiredSchemaFiles = [
     'capability-item.schema.json',
     'capability-availability.schema.json',
     'recommendation-plan.schema.json',
-    'artifact-workspace.schema.json'
+    'artifact-workspace.schema.json',
+    'mcp-server.schema.json',
+    'mcp-install-spec.schema.json',
+    'mcp-install-plan.schema.json',
+    'mcp-apply-result.schema.json',
+    'openspec-change-summary.schema.json',
+    'openspec-render-request.schema.json',
+    'openspec-validation-result.schema.json',
+    'doctor-report.schema.json'
 ];

package/dist/src/shared/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "1.0.11";
+export declare const CLI_VERSION = "1.0.13";

package/dist/src/shared/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "1.0.11";
+export const CLI_VERSION = "1.0.13";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peaks-cli",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Peaks CLI and short skill family for Claude Code automation.",
   "author": "SquabbyZ",
   "license": "MIT",
@@ -35,7 +35,6 @@
     "dev:watch": "node ./scripts/watch.mjs",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "lint": "eslint eslint.config.js \"bin/**/*.js\" \"scripts/**/*.mjs\" \"src/**/*.ts\" \"tests/**/*.ts\" vitest.config.ts",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "engines": {
@@ -47,14 +46,10 @@
     "shadcn": "4.7.0"
   },
   "devDependencies": {
-    "@eslint/js": "^10.0.1",
     "@types/node": "^22.10.2",
     "@vitest/coverage-v8": "^2.1.8",
-    "eslint": "^10.4.0",
-    "globals": "^17.6.0",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
-    "typescript-eslint": "^8.59.4",
     "vitest": "^2.1.8"
   }
 }

package/schemas/doctor-report.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks Doctor Report",
+  "description": "The envelope emitted by `peaks doctor --json` (data field). Each check.id uses a `<prefix>:<target>` form so callers can route follow-up actions per category.",
+  "type": "object",
+  "required": ["checks", "summary"],
+  "properties": {
+    "checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "ok", "message"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^(skill|skill-name|skill-parse|skill-runbook|skill-apply-note|schema|config|doctor-self|capability):[A-Za-z0-9][A-Za-z0-9._-]*$",
+            "description": "Stable check id. Known prefixes: skill:<name> (required skill present), skill-name:<dir> (directory matches declared name), skill-parse:<dir> (skill metadata parsed), skill-runbook:<name> (Default runbook section exists), skill-apply-note:<name> (destructive --apply lines carry an authorization/--dry-run note), schema:<file> (schema file exists and is valid JSON), config:<scope> (optional config locations), doctor-self:<topic> (doctor validates its own output against this schema), capability:<name> (third-party capability is resolvable at the pinned version)."
+          },
+          "ok": { "type": "boolean" },
+          "message": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "required": ["ok", "passed", "failed"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "passed": { "type": "integer", "minimum": 0 },
+        "failed": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/schemas/mcp-apply-result.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks MCP Apply Result",
+  "type": "object",
+  "required": ["capabilityId", "action", "backup", "written", "envCheck"],
+  "properties": {
+    "capabilityId": { "type": "string", "minLength": 1 },
+    "action": {
+      "type": "string",
+      "enum": ["add", "update", "claimed", "noop"],
+      "description": "claimed is returned when an existing non-peaks-managed entry was overwritten with --claim."
+    },
+    "backup": {
+      "type": "object",
+      "required": ["path", "skipped"],
+      "properties": {
+        "path": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1 }
+          ],
+          "description": "Absolute path to the backup settings.json copy. Null when no prior settings existed or skipped is true."
+        },
+        "skipped": {
+          "type": "boolean",
+          "description": "True when action was noop and no write occurred."
+        }
+      }
+    },
+    "written": {
+      "type": "object",
+      "required": ["settingsPath", "managedMarkerPath"],
+      "properties": {
+        "settingsPath": { "type": "string", "minLength": 1 },
+        "managedMarkerPath": { "type": "string", "minLength": 1 }
+      }
+    },
+    "envCheck": {
+      "type": "object",
+      "required": ["missing"],
+      "properties": {
+        "missing": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/schemas/mcp-install-plan.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks MCP Install Plan",
+  "type": "object",
+  "required": ["capabilityId", "action", "spec", "current", "envCheck", "diff", "nextActions"],
+  "properties": {
+    "capabilityId": { "type": "string", "minLength": 1 },
+    "action": {
+      "type": "string",
+      "enum": ["add", "update", "noop", "conflict", "unknown-capability"]
+    },
+    "spec": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "mcp-install-spec.schema.json" }
+      ]
+    },
+    "current": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "mcp-server.schema.json" }
+      ]
+    },
+    "envCheck": {
+      "type": "object",
+      "required": ["missing"],
+      "properties": {
+        "missing": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Env var keys that are not set or are empty."
+        }
+      }
+    },
+    "diff": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "properties": {
+            "command": {
+              "type": "object",
+              "required": ["before", "after"],
+              "properties": {
+                "before": { "type": "string" },
+                "after": { "type": "string" }
+              }
+            },
+            "args": {
+              "type": "object",
+              "required": ["before", "after"],
+              "properties": {
+                "before": { "type": "array", "items": { "type": "string" } },
+                "after": { "type": "array", "items": { "type": "string" } }
+              }
+            },
+            "envKeys": {
+              "type": "object",
+              "required": ["before", "after"],
+              "properties": {
+                "before": { "type": "array", "items": { "type": "string" } },
+                "after": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          }
+        }
+      ]
+    },
+    "nextActions": { "type": "array", "items": { "type": "string" } }
+  }
+}

package/schemas/mcp-install-spec.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks MCP Install Spec",
+  "type": "object",
+  "required": ["capabilityId", "name", "scope", "command", "args", "envKeys"],
+  "properties": {
+    "capabilityId": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Capability id from the Peaks capability map (e.g. context7.docs-lookup)."
+    },
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Server key written into .claude/settings.json mcpServers."
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["global", "project"]
+    },
+    "command": { "type": "string", "minLength": 1 },
+    "args": { "type": "array", "items": { "type": "string" } },
+    "envKeys": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Required env var names. Values are sourced from process.env at runtime and written as ${VAR} placeholders into settings.json."
+    }
+  }
+}

package/schemas/mcp-server.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks MCP Server Config",
+  "type": "object",
+  "required": ["name", "command", "args", "envKeys", "source", "scope"],
+  "properties": {
+    "name": { "type": "string", "minLength": 1 },
+    "command": { "type": "string", "minLength": 1 },
+    "args": { "type": "array", "items": { "type": "string" } },
+    "envKeys": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Names of env vars referenced by the server config. Values are never stored here."
+    },
+    "source": {
+      "type": "string",
+      "enum": ["peaks", "cc-switch", "user", "plugin", "unknown"]
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["global", "project", "plugin"]
+    },
+    "pluginName": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Plugin id (e.g. playwright@claude-plugins-official) when source is plugin."
+    }
+  }
+}

package/schemas/openspec-change-summary.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks OpenSpec Change Summary",
+  "type": "object",
+  "required": ["id", "paths", "specs", "taskProgress"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
+      "description": "OpenSpec change directory name under openspec/changes/."
+    },
+    "paths": {
+      "type": "object",
+      "required": ["root", "proposal", "tasks", "design"],
+      "properties": {
+        "root": { "type": "string", "minLength": 1 },
+        "proposal": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1 }
+          ]
+        },
+        "tasks": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1 }
+          ]
+        },
+        "design": {
+          "oneOf": [
+            { "type": "null" },
+            { "type": "string", "minLength": 1 }
+          ]
+        }
+      }
+    },
+    "specs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Capability names found under specs/<capability>/spec.md."
+    },
+    "taskProgress": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["totalTodo", "doneTodo", "sections"],
+          "properties": {
+            "totalTodo": { "type": "integer", "minimum": 0 },
+            "doneTodo": { "type": "integer", "minimum": 0 },
+            "sections": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": ["heading", "total", "done"],
+                "properties": {
+                  "heading": { "type": "string", "minLength": 1 },
+                  "total": { "type": "integer", "minimum": 0 },
+                  "done": { "type": "integer", "minimum": 0 }
+                }
+              }
+            }
+          }
+        }
+      ]
+    }
+  }
+}

package/schemas/openspec-render-request.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks OpenSpec Render Request",
+  "type": "object",
+  "required": ["changeId", "why", "whatChanges", "acceptanceCriteria"],
+  "properties": {
+    "changeId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
+      "description": "Safe directory name under openspec/changes/. Path traversal sequences are rejected."
+    },
+    "why": {
+      "type": "string",
+      "description": "Plain markdown content for the ## Why section. May be empty (rendered as _None_)."
+    },
+    "whatChanges": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "description": "Bullet items for the ## What Changes section. Empty array renders as _None_ but is a soft warning."
+    },
+    "acceptanceCriteria": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 },
+      "description": "Bullet items for ## Acceptance Criteria. Empty array renders as _None_ but is a hard validation error."
+    },
+    "outOfScope": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "dependencies": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "risks": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["heading", "todos"],
+        "properties": {
+          "heading": { "type": "string", "minLength": 1 },
+          "todos": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "doneItems": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    },
+    "design": {
+      "type": "string",
+      "description": "Raw markdown body for design.md. Passthrough; not parsed by Peaks."
+    }
+  }
+}

package/schemas/openspec-validation-result.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Peaks OpenSpec Validation Result",
+  "type": "object",
+  "required": ["changeId", "valid", "source", "issues"],
+  "properties": {
+    "changeId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "valid": { "type": "boolean" },
+    "source": {
+      "type": "string",
+      "enum": ["internal", "openspec-cli"]
+    },
+    "issues": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["level", "rule", "message"],
+        "properties": {
+          "level": { "type": "string", "enum": ["error", "warning"] },
+          "rule": {
+            "type": "string",
+            "description": "Stable rule id. Internal rules: proposal-exists, what-changes-non-empty, acceptance-non-empty, why-non-empty, change-id-format, openspec-cli-failed, openspec-cli-unavailable."
+          },
+          "message": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "cliOutput": {
+      "type": "string",
+      "description": "Combined stdout+stderr from the external openspec CLI. Only set when source is openspec-cli."
+    }
+  }
+}