@shrkcrft/presets 0.1.0-alpha.2

package/dist/builtin/shared-snippets.js

@@ -0,0 +1,264 @@
+// Reusable knowledge / rule / template / pipeline snippets shared across the
+// built-in presets. Stored as raw TS source strings — they are injected into
+// the synthesized sharkcraft/*.ts files verbatim.
+export const COMMON_AGENT_BRIEFING = `defineKnowledgeEntry({
+    id: 'agent.briefing',
+    title: 'Agent briefing',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.Critical,
+    tags: ['agent', 'safety'],
+    appliesWhen: ['generate-code', 'refactor', 'fix-bug'],
+    content: \`This repo uses SharkCraft. Use shrk CLI or the MCP server to read
+context. Do not write files through MCP — use shrk apply on the CLI.\`,
+    actionHints: {
+      commands: [
+        { command: 'shrk doctor' },
+        { command: 'shrk context --task "<task>"' },
+        { command: 'shrk gen <template> <name> --dry-run --save-plan <plan.json>' },
+      ],
+      mcpTools: ['get_relevant_context', 'get_action_hints', 'create_generation_plan'],
+      forbiddenActions: [
+        'Do not write files through MCP.',
+        'Do not skip dry-run when generating new files.',
+      ],
+      verificationCommands: ['shrk doctor', 'bun x tsc --noEmit'],
+      writePolicy: 'cli-only',
+    },
+  })`;
+export const COMMON_SAFETY_RULE = `defineKnowledgeEntry({
+    id: 'generation.dry-run-by-default',
+    title: 'shrk gen is dry-run by default',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.Critical,
+    tags: ['safety', 'generator'],
+    appliesWhen: ['generate-code'],
+    content: \`Always run shrk gen <id> <name> --dry-run first. Apply with
+--write only after the plan is conflict-free. AI agents must call
+create_generation_plan through MCP — they cannot write through MCP.\`,
+    actionHints: {
+      commands: [
+        { command: 'shrk gen <id> <name> --dry-run --save-plan <plan.json>' },
+        { command: 'shrk apply <plan.json> --verify-signature' },
+      ],
+      mcpTools: ['create_generation_plan', 'explain_generation_target'],
+      forbiddenActions: ['Do not bypass dry-run.', 'Do not write through MCP.'],
+      verificationCommands: ['shrk doctor'],
+      writePolicy: 'cli-only',
+    },
+  })`;
+export const COMMON_PIPELINE_FEATURE_DEV = `definePipeline({
+    id: 'feature-dev',
+    title: 'Feature development flow',
+    description: 'Gather context → plan → dry-run gen → human review → apply.',
+    tags: ['feature', 'generation'],
+    inputs: [
+      { name: 'task', required: true, description: 'Plain-English task description.' },
+    ],
+    steps: [
+      {
+        id: 'context',
+        type: 'context',
+        description: 'Pull relevant rules, paths, templates for the task.',
+        cliCommands: ['shrk context --task "<task>" --max-tokens 3500'],
+        mcpTools: ['get_relevant_context'],
+      },
+      {
+        id: 'rules',
+        type: 'mcp-tool',
+        description: 'Confirm the rules that apply.',
+        mcpTools: ['get_relevant_rules'],
+      },
+      {
+        id: 'plan',
+        type: 'generation-plan',
+        description: 'Build a dry-run plan and save it for review.',
+        cliCommands: [
+          'shrk gen <template> <name> --dry-run --save-plan <plan.json>',
+        ],
+        humanReview: true,
+      },
+      {
+        id: 'apply',
+        type: 'apply-plan',
+        description: 'Human applies the reviewed plan via CLI.',
+        cliCommands: ['shrk apply <plan.json> --verify-signature'],
+        humanReview: true,
+      },
+      {
+        id: 'verify',
+        type: 'command',
+        description: 'Run verification commands.',
+        cliCommands: ['shrk doctor', 'bun x tsc --noEmit'],
+      },
+    ],
+  })`;
+export const COMMON_PIPELINE_CONTEXT_ONLY = `definePipeline({
+    id: 'context-only',
+    title: 'Context-only flow',
+    description: 'Retrieve the relevant slice without generating anything.',
+    tags: ['safe', 'context'],
+    inputs: [
+      { name: 'task', required: true, description: 'Plain-English task description.' },
+    ],
+    steps: [
+      {
+        id: 'overview',
+        type: 'mcp-tool',
+        description: 'Project overview + readiness.',
+        mcpTools: ['get_project_overview', 'get_ai_readiness_report'],
+      },
+      {
+        id: 'context',
+        type: 'context',
+        description: 'Token-budgeted context for the task.',
+        cliCommands: ['shrk context --task "<task>"'],
+        mcpTools: ['get_relevant_context'],
+      },
+      {
+        id: 'hints',
+        type: 'mcp-tool',
+        description: 'Per-task action hints.',
+        mcpTools: ['get_action_hints'],
+      },
+    ],
+  })`;
+export const COMMON_PIPELINE_UNIT_TEST = `definePipeline({
+    id: 'unit-test',
+    title: 'Unit test verification',
+    description: 'Run the project test suite as a verification step.',
+    tags: ['test'],
+    steps: [
+      {
+        id: 'test',
+        type: 'command',
+        description: 'Run unit tests.',
+        cliCommands: ['bun test'],
+      },
+    ],
+  })`;
+export const COMMON_TEMPLATE_SERVICE = `defineTemplate({
+    id: 'typescript.service',
+    name: 'typescript-service',
+    description: 'A minimal TypeScript service class with an init() method.',
+    tags: ['typescript', 'service'],
+    scope: ['app'],
+    appliesWhen: ['generate-service'],
+    variables: [
+      {
+        name: 'className',
+        required: true,
+        description: 'PascalCase class name (e.g. ProfileService).',
+        pattern: /^[A-Z][A-Za-z0-9]+$/,
+      },
+    ],
+    targetPath: (v) => \`src/services/\${kebab(v.className)}.service.ts\`,
+    content: (v) => \`export class \${v.className} {\\n  init(): void {}\\n}\\n\`,
+    postGenerationNotes: ['Wire the new service into your composition root when ready.'],
+  })`;
+export const COMMON_TEMPLATE_UTILITY = `defineTemplate({
+    id: 'typescript.utility',
+    name: 'typescript-utility',
+    description: 'A pure utility module (one exported function per file).',
+    tags: ['typescript', 'utility'],
+    scope: ['app'],
+    appliesWhen: ['generate-utility'],
+    variables: [
+      {
+        name: 'functionName',
+        required: true,
+        description: 'camelCase function name (e.g. formatDate).',
+        pattern: /^[a-z][A-Za-z0-9]+$/,
+      },
+    ],
+    targetPath: (v) => \`src/utils/\${v.functionName}.ts\`,
+    content: (v) => \`export function \${v.functionName}(): void {\\n  // TODO\\n}\\n\`,
+  })`;
+export const COMMON_TEMPLATE_TEST = `defineTemplate({
+    id: 'typescript.unit-test',
+    name: 'typescript-unit-test',
+    description: 'A bun:test unit-test skeleton for an existing module.',
+    tags: ['typescript', 'testing'],
+    scope: ['app'],
+    appliesWhen: ['generate-test'],
+    variables: [
+      {
+        name: 'subject',
+        required: true,
+        description: 'Subject name (used in describe + filename).',
+        pattern: /^[A-Za-z][A-Za-z0-9]+$/,
+      },
+    ],
+    targetPath: (v) => \`tests/\${v.subject}.spec.ts\`,
+    content: (v) =>
+      \`import { describe, expect, test } from 'bun:test';\\n\\ndescribe('\${v.subject}', () => {\\n  test('placeholder', () => {\\n    expect(true).toBe(true);\\n  });\\n});\\n\`,
+  })`;
+// Helper available to template content. Defined at the top of templates.ts so
+// each template can reference it. Adding it inline keeps generated files
+// self-contained.
+export const TEMPLATE_HELPERS = `function kebab(s: string): string {
+  return s
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/[^A-Za-z0-9]+/g, '-')
+    .toLowerCase();
+}`;
+export const COMMON_PATH_SERVICES = `defineKnowledgeEntry({
+    id: 'paths.services',
+    title: 'Services live in src/services/',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'services'],
+    scope: ['app'],
+    appliesWhen: ['generate-service'],
+    content: 'Service classes live in src/services/. One service per file.',
+  })`;
+export const COMMON_PATH_UTILS = `defineKnowledgeEntry({
+    id: 'paths.utils',
+    title: 'Utilities live in src/utils/',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'utils'],
+    appliesWhen: ['generate-utility'],
+    content: 'Pure helpers live in src/utils/. One function per file.',
+  })`;
+export const COMMON_PATH_TESTS = `defineKnowledgeEntry({
+    id: 'paths.tests',
+    title: 'Tests live in tests/',
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.Medium,
+    tags: ['paths', 'tests'],
+    appliesWhen: ['generate-test'],
+    content: 'Unit tests live under tests/, mirroring src/. Use *.spec.ts.',
+  })`;
+export const COMMON_RULE_INTERFACE_PREFIX = `defineKnowledgeEntry({
+    id: 'typescript.interfaces.i-prefix',
+    title: 'Prefix interfaces with I',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['typescript', 'naming'],
+    appliesWhen: ['generate-code', 'refactor'],
+    content: 'Interfaces use an I-prefix (IUser, IConfig). Enums are preferred over unions for closed sets.',
+  })`;
+export const COMMON_RULE_ONE_EXPORT = `defineKnowledgeEntry({
+    id: 'typescript.files.one-export',
+    title: 'One exported construct per file',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['typescript', 'structure'],
+    appliesWhen: ['generate-code'],
+    content: 'Each TypeScript file exports exactly one top-level construct. Helpers live in their own file.',
+  })`;
+export const COMMON_RULE_NO_LOGIC_CONSTRUCTORS = `defineKnowledgeEntry({
+    id: 'typescript.constructors.no-logic',
+    title: 'No business logic in constructors',
+    type: KnowledgeType.Rule,
+    priority: KnowledgePriority.High,
+    tags: ['typescript'],
+    appliesWhen: ['generate-code'],
+    content: 'Constructors wire dependencies only. Initialization belongs in init().',
+  })`;
+export const OVERVIEW_DOC = (title, body) => `# ${title}
+
+${body}
+
+> Generated by \`shrk presets apply\`. SharkCraft (CLI + MCP) is the source of truth — this file is a human-readable companion.
+`;

package/dist/define/define-preset.d.ts

@@ -0,0 +1,4 @@
+import type { IPreset } from '../model/preset.js';
+/** Identity helper for declaring presets with type inference. */
+export declare function definePreset<T extends IPreset>(preset: T): T;
+//# sourceMappingURL=define-preset.d.ts.map

package/dist/define/define-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-preset.d.ts","sourceRoot":"","sources":["../../src/define/define-preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAE5D"}

package/dist/define/define-preset.js

@@ -0,0 +1,4 @@
+/** Identity helper for declaring presets with type inference. */
+export function definePreset(preset) {
+    return preset;
+}

package/dist/emit/synthesize-files.d.ts

@@ -0,0 +1,26 @@
+import type { IPreset, IPresetIncludes } from '../model/preset.js';
+export interface ISynthesizedFile {
+    /** Path relative to sharkcraft/. */
+    path: string;
+    content: string;
+    /** Why this file was produced. */
+    kind: 'config' | 'knowledge' | 'rules' | 'paths' | 'templates' | 'pipelines' | 'docs' | 'tasks' | 'import-draft' | 'literal';
+}
+/**
+ * Pure synthesizer: return the list of files this preset would create under
+ * the target's sharkcraft/ folder. Does not touch disk.
+ */
+export declare function synthesizePresetFiles(preset: IPreset): ISynthesizedFile[];
+/**
+ * Synthesize files from a flattened {@link IResolvedPreset}. Uses the merged
+ * `includes` from composition rather than the root preset's local includes.
+ */
+export declare function synthesizeResolvedPresetFiles(resolved: {
+    preset: IPreset;
+    includes: IPresetIncludes;
+    filesToCreate: readonly {
+        path: string;
+        content: string;
+    }[];
+}): ISynthesizedFile[];
+//# sourceMappingURL=synthesize-files.d.ts.map

package/dist/emit/synthesize-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize-files.d.ts","sourceRoot":"","sources":["../../src/emit/synthesize-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,IAAI,EACA,QAAQ,GACR,WAAW,GACX,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,cAAc,GACd,SAAS,CAAC;CACf;AAsID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAEzE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE;IACtD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC7D,GAAG,gBAAgB,EAAE,CAErB"}

package/dist/emit/synthesize-files.js

@@ -0,0 +1,172 @@
+function recordToMap(v) {
+    if (!v)
+        return new Map();
+    if (v instanceof Map)
+        return v;
+    return new Map(Object.entries(v));
+}
+function listBlock(items, indent = '  ') {
+    if (!items || items.length === 0)
+        return '';
+    return items.map((expr) => indent + expr.replace(/\n/g, `\n${indent}`)).join(',\n') + ',\n';
+}
+function knowledgeFile(items) {
+    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
+        'const knowledge = [\n' +
+        listBlock(items) +
+        '];\n\n' +
+        'export default knowledge;\n');
+}
+function rulesFile(items) {
+    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
+        'const rules = [\n' +
+        listBlock(items) +
+        '];\n\n' +
+        'export default rules;\n');
+}
+function pathsFile(items) {
+    return ("import { defineKnowledgeEntry, KnowledgePriority, KnowledgeType } from '@shrkcrft/knowledge';\n\n" +
+        'const paths = [\n' +
+        listBlock(items) +
+        '];\n\n' +
+        'export default paths;\n');
+}
+function templatesFile(items) {
+    // Inject a small kebab helper so template content() closures can use it.
+    // Generated code is self-contained — no extra runtime dependency required.
+    return ("import { defineTemplate } from '@shrkcrft/templates';\n\n" +
+        'function kebab(s: string): string {\n' +
+        "  return s.replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[^A-Za-z0-9]+/g, '-').toLowerCase();\n" +
+        '}\n\n' +
+        'const templates = [\n' +
+        listBlock(items) +
+        '];\n\n' +
+        'export default templates;\n');
+}
+function pipelinesFile(items) {
+    return ("import { definePipeline } from '@shrkcrft/pipelines';\n\n" +
+        'const pipelines = [\n' +
+        listBlock(items) +
+        '];\n\n' +
+        'export default pipelines;\n');
+}
+function configFile(preset) {
+    // Generic config that points at the standard knowledge/rules/paths/etc.
+    // files. Consumers can tailor it later.
+    const filesByKind = inferFiles(preset);
+    const knowledgeFiles = filesByKind.has('knowledge.ts') ? ['knowledge.ts'] : [];
+    const ruleFiles = filesByKind.has('rules.ts') ? ['rules.ts'] : [];
+    const pathFiles = filesByKind.has('paths.ts') ? ['paths.ts'] : [];
+    const templateFiles = filesByKind.has('templates.ts') ? ['templates.ts'] : [];
+    const pipelineFiles = filesByKind.has('pipelines.ts') ? ['pipelines.ts'] : [];
+    const docsList = [...filesByKind.keys()].filter((p) => p.startsWith('docs/'));
+    // When the preset declares a `surfaceProfile`, emit a `surface.profile`
+    // block so the project starts with the right visible slice without
+    // needing a separate `shrk surface` step.
+    const surfaceBlock = preset.surfaceProfile
+        ? `  surface: { profile: ${JSON.stringify(preset.surfaceProfile)} },\n`
+        : '';
+    return (`// Generated by \`shrk presets apply ${preset.id}\`.\n` +
+        '// Edit freely. SharkCraft does not regenerate this file.\n\n' +
+        'const config = {\n' +
+        `  projectName: 'shrk-project',\n` +
+        `  description: ${JSON.stringify(preset.description)},\n` +
+        `  knowledgeFiles: ${JSON.stringify(knowledgeFiles)},\n` +
+        `  ruleFiles: ${JSON.stringify(ruleFiles)},\n` +
+        `  pathFiles: ${JSON.stringify(pathFiles)},\n` +
+        `  templateFiles: ${JSON.stringify(templateFiles)},\n` +
+        `  pipelineFiles: ${JSON.stringify(pipelineFiles)},\n` +
+        `  docsFiles: ${JSON.stringify(docsList)},\n` +
+        `  defaultMaxTokens: 3500,\n` +
+        surfaceBlock +
+        '};\n\n' +
+        'export default config;\n');
+}
+function inferFiles(preset) {
+    const files = new Map();
+    const inc = preset.includes;
+    if (inc.knowledge && inc.knowledge.length > 0) {
+        files.set('knowledge.ts', knowledgeFile(inc.knowledge));
+    }
+    if (inc.rules && inc.rules.length > 0) {
+        files.set('rules.ts', rulesFile(inc.rules));
+    }
+    if (inc.paths && inc.paths.length > 0) {
+        files.set('paths.ts', pathsFile(inc.paths));
+    }
+    if (inc.templates && inc.templates.length > 0) {
+        files.set('templates.ts', templatesFile(inc.templates));
+    }
+    if (inc.pipelines && inc.pipelines.length > 0) {
+        files.set('pipelines.ts', pipelinesFile(inc.pipelines));
+    }
+    const docs = recordToMap(inc.docs);
+    for (const [name, content] of docs) {
+        files.set(`docs/${name}`, content);
+    }
+    const tasks = recordToMap(inc.tasks);
+    for (const [name, content] of tasks) {
+        files.set(`tasks/${name}`, content);
+    }
+    return files;
+}
+/**
+ * Pure synthesizer: return the list of files this preset would create under
+ * the target's sharkcraft/ folder. Does not touch disk.
+ */
+export function synthesizePresetFiles(preset) {
+    return synthesizeFromIncludes(preset, preset.includes, preset.filesToCreate ?? []);
+}
+/**
+ * Synthesize files from a flattened {@link IResolvedPreset}. Uses the merged
+ * `includes` from composition rather than the root preset's local includes.
+ */
+export function synthesizeResolvedPresetFiles(resolved) {
+    return synthesizeFromIncludes(resolved.preset, resolved.includes, resolved.filesToCreate);
+}
+function synthesizeFromIncludes(preset, includes, filesToCreate) {
+    const out = [];
+    out.push({ path: 'sharkcraft.config.ts', content: configFile({ ...preset, includes }), kind: 'config' });
+    const files = inferFilesFromIncludes(includes);
+    for (const [path, content] of files) {
+        const kind = path.endsWith('.ts')
+            ? path.replace('.ts', '')
+            : path.startsWith('docs/')
+                ? 'docs'
+                : path.startsWith('tasks/')
+                    ? 'tasks'
+                    : 'literal';
+        out.push({ path, content, kind });
+    }
+    for (const f of filesToCreate) {
+        out.push({ path: f.path, content: f.content, kind: 'literal' });
+    }
+    return out;
+}
+function inferFilesFromIncludes(inc) {
+    const files = new Map();
+    if (inc.knowledge && inc.knowledge.length > 0) {
+        files.set('knowledge.ts', knowledgeFile(inc.knowledge));
+    }
+    if (inc.rules && inc.rules.length > 0) {
+        files.set('rules.ts', rulesFile(inc.rules));
+    }
+    if (inc.paths && inc.paths.length > 0) {
+        files.set('paths.ts', pathsFile(inc.paths));
+    }
+    if (inc.templates && inc.templates.length > 0) {
+        files.set('templates.ts', templatesFile(inc.templates));
+    }
+    if (inc.pipelines && inc.pipelines.length > 0) {
+        files.set('pipelines.ts', pipelinesFile(inc.pipelines));
+    }
+    const docs = recordToMap(inc.docs);
+    for (const [name, content] of docs) {
+        files.set(`docs/${name}`, content);
+    }
+    const tasks = recordToMap(inc.tasks);
+    for (const [name, content] of tasks) {
+        files.set(`tasks/${name}`, content);
+    }
+    return files;
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './model/preset.js';
+export * from './define/define-preset.js';
+export * from './registry/preset-registry.js';
+export * from './registry/load-presets.js';
+export * from './registry/recommend.js';
+export * from './emit/synthesize-files.js';
+export * from './apply/preview-apply.js';
+export * from './registry/resolve-preset.js';
+export * from './registry/resolve-references.js';
+export * from './builtin/builtin-presets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./model/preset.js";
+export * from "./define/define-preset.js";
+export * from "./registry/preset-registry.js";
+export * from "./registry/load-presets.js";
+export * from "./registry/recommend.js";
+export * from "./emit/synthesize-files.js";
+export * from "./apply/preview-apply.js";
+export * from "./registry/resolve-preset.js";
+export * from "./registry/resolve-references.js";
+export * from "./builtin/builtin-presets.js";

package/dist/model/preset.d.ts

@@ -0,0 +1,83 @@
+import type { WorkspaceProfile } from '@shrkcrft/workspace';
+/**
+ * A preset is a reusable, additive SharkCraft project setup. Presets are
+ * applied to a target repo through the CLI — never through MCP.
+ *
+ * Presets ship **content** (knowledge / rules / paths / templates / pipelines /
+ * docs / tasks) plus metadata describing where they fit and what should
+ * happen next. They are NOT executable code; they are typed data the
+ * apply step renders into source files in the consumer's sharkcraft/ folder.
+ */
+export interface IPresetFile {
+    /** Relative path inside the target's sharkcraft/ folder. */
+    path: string;
+    /** Literal content to write. */
+    content: string;
+}
+export interface IPresetIncludes {
+    /** TS expressions for KnowledgeEntry objects (rendered into knowledge.ts). */
+    knowledge?: readonly string[];
+    /** TS expressions for KnowledgeEntry-shaped rule objects. */
+    rules?: readonly string[];
+    /** TS expressions for PathConvention KnowledgeEntry objects. */
+    paths?: readonly string[];
+    /** TS expressions for ITemplateDefinition objects. */
+    templates?: readonly string[];
+    /** TS expressions for IPipelineDefinition objects. */
+    pipelines?: readonly string[];
+    /** Filename → markdown content for sharkcraft/docs/<filename>. */
+    docs?: ReadonlyMap<string, string> | Readonly<Record<string, string>>;
+    /** Filename → markdown content for sharkcraft/tasks/<filename>. */
+    tasks?: ReadonlyMap<string, string> | Readonly<Record<string, string>>;
+    knowledgeIds?: readonly string[];
+    ruleIds?: readonly string[];
+    pathConventionIds?: readonly string[];
+    templateIds?: readonly string[];
+    pipelineIds?: readonly string[];
+}
+export interface IPreset {
+    /** Stable id (slug-style). */
+    id: string;
+    /** Short human title. */
+    title: string;
+    /** Free-form description. */
+    description: string;
+    /** Tags for grouping/filtering. */
+    tags?: readonly string[];
+    /** Profile tags this preset is appropriate for (used by recommendation). */
+    appliesTo?: readonly WorkspaceProfile[];
+    /** Profile tags this preset is INappropriate for (used by recommendation). */
+    notAppropriateFor?: readonly WorkspaceProfile[];
+    /** Higher = stronger recommendation when applicable. Default 5 (1..10). */
+    weight?: number;
+    /** Bundled content to merge into the target's sharkcraft/ folder. */
+    includes: IPresetIncludes;
+    /** Verbatim file writes (non-knowledge files). */
+    filesToCreate?: readonly IPresetFile[];
+    /** Notes printed after `shrk presets apply --write` finishes. */
+    postInstallNotes?: readonly string[];
+    /** Commands the human should run next. */
+    recommendedNextCommands?: readonly string[];
+    /** Free-form safety notes printed before any write. */
+    safetyNotes?: readonly string[];
+    /** Other preset ids this one composes; applied first, current preset wins. */
+    composes?: readonly string[];
+    /**
+     * Surface profile id this preset selects when
+     * applied via `shrk init`. The init flow writes `surface.profile:
+     * '<id>'` into the generated `sharkcraft.config.ts`. Set to one of
+     * the built-in profile ids (`developer`, `small-app`, `monorepo`,
+     * `pack-author`, `ci`, `agent`) or a pack-contributed profile id.
+     */
+    surfaceProfile?: string;
+}
+export interface IPresetValidationIssue {
+    field: string;
+    message: string;
+}
+export interface IPresetValidationResult {
+    valid: boolean;
+    issues: IPresetValidationIssue[];
+}
+export declare function validatePreset(value: unknown): IPresetValidationResult;
+//# sourceMappingURL=preset.d.ts.map

package/dist/model/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/model/preset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,sDAAsD;IACtD,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,sDAAsD;IACtD,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,kEAAkE;IAClE,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,mEAAmE;IACnE,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAKvE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,OAAO;IACtB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,eAAe,CAAC;IAC1B,kDAAkD;IAClD,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,0CAA0C;IAC1C,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,uDAAuD;IACvD,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAID,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAmBtE"}

package/dist/model/preset.js

@@ -0,0 +1,21 @@
+const ID_PATTERN = /^[a-z0-9][a-z0-9._-]*$/;
+export function validatePreset(value) {
+    const issues = [];
+    if (!value || typeof value !== 'object') {
+        return { valid: false, issues: [{ field: '<root>', message: 'preset must be an object' }] };
+    }
+    const p = value;
+    if (typeof p.id !== 'string' || !ID_PATTERN.test(p.id)) {
+        issues.push({ field: 'id', message: 'id must be a slug-style string' });
+    }
+    if (typeof p.title !== 'string' || p.title.length === 0) {
+        issues.push({ field: 'title', message: 'title required' });
+    }
+    if (typeof p.description !== 'string' || p.description.length === 0) {
+        issues.push({ field: 'description', message: 'description required' });
+    }
+    if (!p.includes || typeof p.includes !== 'object') {
+        issues.push({ field: 'includes', message: 'includes object required' });
+    }
+    return { valid: issues.length === 0, issues };
+}

package/dist/registry/load-presets.d.ts

@@ -0,0 +1,12 @@
+import { type IImportContext } from '@shrkcrft/core';
+import type { IPreset } from '../model/preset.js';
+export interface ILoadedPresetFile {
+    source: string;
+    presets: IPreset[];
+    warnings: string[];
+}
+export interface ILoadPresetsOptions {
+    importContext?: IImportContext;
+}
+export declare function loadPresetsFromFile(absPath: string, options?: ILoadPresetsOptions): Promise<ILoadedPresetFile>;
+//# sourceMappingURL=load-presets.d.ts.map

package/dist/registry/load-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-presets.d.ts","sourceRoot":"","sources":["../../src/registry/load-presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,cAAc,EAAc,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CA2B5B"}