@shrkcrft/plugin-api 0.1.0-alpha.8 → 0.1.0-alpha.9

package/README.md

@@ -2,7 +2,7 @@
 
 SharkCraft plugin API: extension points for commands, knowledge, templates, MCP tools.
 
-Part of [SharkCraft](https://github.com/shrkcrft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
+Part of [SharkCraft](https://github.com/sharkcraft/sharkcraft) — a deterministic, local-first toolkit that gives AI coding agents durable project context. See the main repo for documentation, examples, and the `shrk` CLI.
 
 ## Install
 

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export * from './construct.js';
 export * from './playbook.js';
 export * from './policy-check.js';
 export * from './search-tuning.js';
+export * from './plugin-lifecycle-profile.js';
 export * from './convention.js';
 export * from './pack-helper.js';
 export * from './task-routing-hint.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -12,6 +12,7 @@ export * from "./construct.js";
 export * from "./playbook.js";
 export * from "./policy-check.js";
 export * from "./search-tuning.js";
+export * from "./plugin-lifecycle-profile.js";
 export * from "./convention.js";
 export * from "./pack-helper.js";
 export * from "./task-routing-hint.js";

package/dist/pack-manifest.d.ts

@@ -64,6 +64,8 @@ export interface ISharkCraftPackContributions {
     decisionFiles?: readonly string[];
     /** Pack-extensible path conventions when separate from `pathFiles`. */
     pathConventionFiles?: readonly string[];
+    /** Pack-contributed plugin lifecycle profiles. Files default-export `readonly IPluginLifecycleProfile[]`. */
+    pluginLifecycleProfileFiles?: readonly string[];
     /** Pack-contributed agent-contract templates. Files default-export `readonly IAgentContractTemplate[]`. */
     contractTemplateFiles?: readonly string[];
     /** Pack-contributed migration readiness profiles. */

package/dist/pack-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../src/pack-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pack-manifest.d.ts","sourceRoot":"","sources":["../src/pack-manifest.ts"],"names":[],"mappings":"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"}

package/dist/pack-manifest.js

@@ -66,6 +66,7 @@ export function validatePackManifest(value) {
             'feedbackRuleFiles',
             'decisionFiles',
             'pathConventionFiles',
+            'pluginLifecycleProfileFiles',
             'contractTemplateFiles',
             'migrationProfileFiles',
             'conventionFiles',

package/dist/plugin-lifecycle-profile.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Plugin lifecycle profile (generic).
+ *
+ * A pack can contribute one or more lifecycle profiles describing where its
+ * plugins live, what their barrels and key-tables look like, and which
+ * registry files participate. The engine reads these profiles and plans
+ * plugin rename / remove operations against them.
+ *
+ * The engine never embeds project-specific plugin layouts; all of that comes
+ * from a profile. Pack contributions are static data — no executable code.
+ */
+export declare enum PluginLifecycleRootKind {
+    Api = "api",
+    Cross = "cross",
+    Ui = "ui",
+    Angular = "angular",
+    React = "react",
+    Node = "node",
+    Runtime = "runtime",
+    Other = "other"
+}
+export interface IPluginLifecycleRoot {
+    readonly id: string;
+    readonly path: string;
+    readonly kind?: PluginLifecycleRootKind;
+    readonly pluginFolderSegment?: string;
+}
+export declare enum BarrelSort {
+    Alphabetical = "alphabetical",
+    Preserve = "preserve",
+    Append = "append"
+}
+export interface IPluginLifecycleBarrel {
+    readonly id: string;
+    readonly path: string;
+    readonly exportSegment?: string;
+    readonly sort?: BarrelSort;
+}
+export declare enum CaseStyle {
+    UpperSnake = "upperSnake",
+    Pascal = "pascal",
+    Camel = "camel",
+    Kebab = "kebab"
+}
+export interface IPluginLifecycleKeyTable {
+    readonly path: string;
+    readonly keyCase: CaseStyle;
+    readonly valueCase: CaseStyle;
+    readonly entryAnchor?: string;
+    readonly id?: string;
+}
+export declare enum PluginRegistryFileKind {
+    PluginKey = "plugin-key",
+    UserPluginEntry = "user-plugin-entry",
+    Defaults = "defaults",
+    Event = "event",
+    Command = "command",
+    Composer = "composer",
+    Other = "other"
+}
+export interface IPluginLifecycleRegistryFile {
+    readonly id: string;
+    readonly path: string;
+    readonly kind: PluginRegistryFileKind;
+    readonly entryPattern?: string;
+}
+export interface IPluginLifecycleNaming {
+    readonly pluginIdCase?: CaseStyle;
+    readonly classNameSuffix?: string;
+}
+export interface IPluginLifecycleProfile {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly pluginRoots: readonly IPluginLifecycleRoot[];
+    readonly barrels?: readonly IPluginLifecycleBarrel[];
+    readonly keyTable?: IPluginLifecycleKeyTable;
+    readonly registryFiles?: readonly IPluginLifecycleRegistryFile[];
+    readonly naming?: IPluginLifecycleNaming;
+    readonly validationCommands?: readonly string[];
+    readonly safetyNotes?: readonly string[];
+    readonly appliesWhen?: readonly string[];
+    readonly tags?: readonly string[];
+}
+export interface IPluginLifecycleProfileValidationIssue {
+    readonly field: string;
+    readonly message: string;
+}
+export interface IPluginLifecycleProfileValidationResult {
+    readonly valid: boolean;
+    readonly issues: readonly IPluginLifecycleProfileValidationIssue[];
+}
+/**
+ * Validate a plugin lifecycle profile shape. Lightweight runtime check; no
+ * dependency on zod (plugin-api stays dependency-light, like pack-manifest).
+ */
+export declare function validatePluginLifecycleProfile(value: unknown): IPluginLifecycleProfileValidationResult;
+//# sourceMappingURL=plugin-lifecycle-profile.d.ts.map

package/dist/plugin-lifecycle-profile.d.ts.map

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

package/dist/plugin-lifecycle-profile.js

@@ -0,0 +1,119 @@
+/**
+ * Plugin lifecycle profile (generic).
+ *
+ * A pack can contribute one or more lifecycle profiles describing where its
+ * plugins live, what their barrels and key-tables look like, and which
+ * registry files participate. The engine reads these profiles and plans
+ * plugin rename / remove operations against them.
+ *
+ * The engine never embeds project-specific plugin layouts; all of that comes
+ * from a profile. Pack contributions are static data — no executable code.
+ */
+export var PluginLifecycleRootKind;
+(function (PluginLifecycleRootKind) {
+    PluginLifecycleRootKind["Api"] = "api";
+    PluginLifecycleRootKind["Cross"] = "cross";
+    PluginLifecycleRootKind["Ui"] = "ui";
+    PluginLifecycleRootKind["Angular"] = "angular";
+    PluginLifecycleRootKind["React"] = "react";
+    PluginLifecycleRootKind["Node"] = "node";
+    PluginLifecycleRootKind["Runtime"] = "runtime";
+    PluginLifecycleRootKind["Other"] = "other";
+})(PluginLifecycleRootKind || (PluginLifecycleRootKind = {}));
+export var BarrelSort;
+(function (BarrelSort) {
+    BarrelSort["Alphabetical"] = "alphabetical";
+    BarrelSort["Preserve"] = "preserve";
+    BarrelSort["Append"] = "append";
+})(BarrelSort || (BarrelSort = {}));
+export var CaseStyle;
+(function (CaseStyle) {
+    CaseStyle["UpperSnake"] = "upperSnake";
+    CaseStyle["Pascal"] = "pascal";
+    CaseStyle["Camel"] = "camel";
+    CaseStyle["Kebab"] = "kebab";
+})(CaseStyle || (CaseStyle = {}));
+export var PluginRegistryFileKind;
+(function (PluginRegistryFileKind) {
+    PluginRegistryFileKind["PluginKey"] = "plugin-key";
+    PluginRegistryFileKind["UserPluginEntry"] = "user-plugin-entry";
+    PluginRegistryFileKind["Defaults"] = "defaults";
+    PluginRegistryFileKind["Event"] = "event";
+    PluginRegistryFileKind["Command"] = "command";
+    PluginRegistryFileKind["Composer"] = "composer";
+    PluginRegistryFileKind["Other"] = "other";
+})(PluginRegistryFileKind || (PluginRegistryFileKind = {}));
+/**
+ * Validate a plugin lifecycle profile shape. Lightweight runtime check; no
+ * dependency on zod (plugin-api stays dependency-light, like pack-manifest).
+ */
+export function validatePluginLifecycleProfile(value) {
+    const issues = [];
+    if (!value || typeof value !== 'object') {
+        return { valid: false, issues: [{ field: '<root>', message: 'profile must be an object' }] };
+    }
+    const obj = value;
+    if (typeof obj.id !== 'string' || obj.id.length === 0) {
+        issues.push({ field: 'id', message: 'id must be a non-empty string' });
+    }
+    if (typeof obj.title !== 'string' || obj.title.length === 0) {
+        issues.push({ field: 'title', message: 'title must be a non-empty string' });
+    }
+    if (!Array.isArray(obj.pluginRoots) || obj.pluginRoots.length === 0) {
+        issues.push({ field: 'pluginRoots', message: 'pluginRoots must be a non-empty array' });
+    }
+    else {
+        obj.pluginRoots.forEach((root, idx) => {
+            if (!root || typeof root !== 'object') {
+                issues.push({ field: `pluginRoots[${idx}]`, message: 'root must be an object' });
+                return;
+            }
+            const r = root;
+            if (typeof r.id !== 'string' || r.id.length === 0) {
+                issues.push({ field: `pluginRoots[${idx}].id`, message: 'id required' });
+            }
+            if (typeof r.path !== 'string' || r.path.length === 0) {
+                issues.push({ field: `pluginRoots[${idx}].path`, message: 'path required' });
+            }
+        });
+    }
+    if (obj.barrels !== undefined) {
+        if (!Array.isArray(obj.barrels)) {
+            issues.push({ field: 'barrels', message: 'barrels must be an array' });
+        }
+        else {
+            obj.barrels.forEach((b, idx) => {
+                if (!b || typeof b !== 'object') {
+                    issues.push({ field: `barrels[${idx}]`, message: 'barrel must be an object' });
+                    return;
+                }
+                const br = b;
+                if (typeof br.id !== 'string' || br.id.length === 0) {
+                    issues.push({ field: `barrels[${idx}].id`, message: 'id required' });
+                }
+                if (typeof br.path !== 'string' || br.path.length === 0) {
+                    issues.push({ field: `barrels[${idx}].path`, message: 'path required' });
+                }
+            });
+        }
+    }
+    if (obj.keyTable !== undefined && obj.keyTable !== null) {
+        const k = obj.keyTable;
+        if (typeof k !== 'object') {
+            issues.push({ field: 'keyTable', message: 'keyTable must be an object' });
+        }
+        else {
+            if (typeof k.path !== 'string' || k.path.length === 0) {
+                issues.push({ field: 'keyTable.path', message: 'path required' });
+            }
+            const validCase = new Set(['upperSnake', 'pascal', 'camel', 'kebab']);
+            if (typeof k.keyCase !== 'string' || !validCase.has(k.keyCase)) {
+                issues.push({ field: 'keyTable.keyCase', message: 'keyCase must be one of upperSnake|pascal|camel|kebab' });
+            }
+            if (typeof k.valueCase !== 'string' || !validCase.has(k.valueCase)) {
+                issues.push({ field: 'keyTable.valueCase', message: 'valueCase must be one of upperSnake|pascal|camel|kebab' });
+            }
+        }
+    }
+    return { valid: issues.length === 0, issues };
+}

package/dist/scaffold-pattern.d.ts

@@ -19,7 +19,7 @@ export interface IScaffoldPatternVariable {
     description?: string;
 }
 export interface IScaffoldPattern {
-    /** Stable id, e.g. "myproj.service-pattern". */
+    /** Stable id, e.g. "myproj.plugin-contract-pattern". */
     id: string;
     /** Short human-readable title. */
     title: string;
@@ -34,7 +34,7 @@ export interface IScaffoldPattern {
     /** Variable extraction strategies. */
     variables: readonly IScaffoldPatternVariable[];
     /** Lifecycle hooks where this pattern is consulted. */
-    appliesWhen: readonly ('onboard' | 'infer-template' | string)[];
+    appliesWhen: readonly ('onboard' | 'infer-template' | 'create-plugin' | string)[];
     /** Confidence floor when matched. */
     confidence: 'high' | 'medium' | 'low';
     /** Free-form tags for grouping. */

package/dist/scaffold-pattern.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-pattern.d.ts","sourceRoot":"","sources":["../src/scaffold-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAClC,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,yBAAyB,MAAM,EAAE,GACjC,cAAc,GACd,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,0BAA0B,CAAC;IACjC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iCAAiC;IACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC/C,uDAAuD;IACvD,WAAW,EAAE,SAAS,CAAC,SAAS,GAAG,gBAAgB,GAAG,MAAM,CAAC,EAAE,CAAC;IAChE,qCAAqC;IACrC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAEjF;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,SAAS,gBAAgB,EAAE,CAE7B;AAED,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAO7D,CAAC;AAEH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D"}
+{"version":3,"file":"scaffold-pattern.d.ts","sourceRoot":"","sources":["../src/scaffold-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,0BAA0B,GAClC,gBAAgB,GAChB,iBAAiB,GACjB,WAAW,GACX,yBAAyB,MAAM,EAAE,GACjC,cAAc,GACd,eAAe,GACf,oBAAoB,CAAC;AAEzB,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,0BAA0B,CAAC;IACjC,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,iCAAiC;IACjC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC/C,uDAAuD;IACvD,WAAW,EAAE,SAAS,CAAC,SAAS,GAAG,gBAAgB,GAAG,eAAe,GAAG,MAAM,CAAC,EAAE,CAAC;IAClF,qCAAqC;IACrC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAEjF;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GACpC,SAAS,gBAAgB,EAAE,CAE7B;AAED,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAO7D,CAAC;AAEH,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAI/D"}

package/package.json

@@ -1,16 +1,15 @@
 {
   "name": "@shrkcrft/plugin-api",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-alpha.9",
   "description": "SharkCraft plugin API: extension points for commands, knowledge, templates, MCP tools.",
   "license": "MIT",
   "author": "SharkCraft contributors",
   "type": "module",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.d.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     }
@@ -22,12 +21,12 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/shrkcrft/sharkcraft.git",
+    "url": "git+https://github.com/sharkcraft/sharkcraft.git",
     "directory": "packages/plugin-api"
   },
-  "homepage": "https://github.com/shrkcrft/sharkcraft",
+  "homepage": "https://github.com/sharkcraft/sharkcraft",
   "bugs": {
-    "url": "https://github.com/shrkcrft/sharkcraft/issues"
+    "url": "https://github.com/sharkcraft/sharkcraft/issues"
   },
   "keywords": [
     "sharkcraft",
@@ -41,7 +40,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.8"
+    "@shrkcrft/core": "^0.1.0-alpha.9"
   },
   "publishConfig": {
     "access": "public"