@shrkcrft/cli 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/commands/init.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAuQjH,eAAO,MAAM,WAAW,EAAE,eA2FzB,CAAC"}
+{"version":3,"file":"init.command.d.ts","sourceRoot":"","sources":["../../src/commands/init.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AAmSjH,eAAO,MAAM,WAAW,EAAE,eA2FzB,CAAC"}

package/dist/commands/init.command.js

@@ -6,6 +6,7 @@ import { listBuiltInSurfaceProfiles, suggestSurfaceProfile } from '@shrkcrft/ins
 import { INIT_FILES } from "../init/init-templates.js";
 import { buildDetectedBlock, renderDetectedBlockText } from "../init/detected-block.js";
 import { ensureSharkcraftGitignore, renderGitignorePatch } from "../init/gitignore.js";
+import { annotatePathsAgainstDisk } from "../init/paths-advisory.js";
 import { applySurfaceTextEdit } from "../surface/surface-config-writer.js";
 import { flagBool, flagString, resolveCwd } from "../command-registry.js";
 import { bullet, header } from "../output/format-output.js";
@@ -133,6 +134,11 @@ async function applyPresetInit(cwd, mode) {
             source: 'override',
         });
     }
+    // Workspace-shape advisory: when the preset emits path conventions
+    // that don't exist in this repo (common with generic presets in
+    // framework-specific repos), annotate paths.ts so the user knows
+    // which defaults to fix.
+    const pathsAdvisory = annotatePathsAgainstDisk(cwd, plan.sharkcraftDir);
     process.stdout.write(header('SharkCraft initialized'));
     process.stdout.write(`Preset: ${preset.id} — ${preset.title}\n`);
     process.stdout.write(`Folder: ${plan.sharkcraftDir}\n`);
@@ -169,6 +175,9 @@ async function applyPresetInit(cwd, mode) {
             process.stdout.write('\n' + renderGitignorePatch(patch, false));
         }
     }
+    if (pathsAdvisory.annotated) {
+        renderPathsAdvisory(pathsAdvisory);
+    }
     process.stdout.write('\nNext:\n');
     for (const cmd of preset.recommendedNextCommands ?? [
         'shrk doctor',
@@ -179,6 +188,16 @@ async function applyPresetInit(cwd, mode) {
     process.stdout.write(bullet('Start the MCP server: `shrk mcp serve` (or run it via Claude Code)') + '\n');
     return 0;
 }
+function renderPathsAdvisory(advisory) {
+    process.stdout.write('\n');
+    process.stdout.write(header('Paths advisory'));
+    process.stdout.write('These preset-default paths do not exist in this repo:\n');
+    for (const p of advisory.missingPaths) {
+        process.stdout.write(bullet(p) + '\n');
+    }
+    process.stdout.write('\nEdit sharkcraft/paths.ts to match your real layout. ' +
+        'Run `shrk onboard --dry-run` to see what the engine infers.\n');
+}
 function applyLegacyInit(cwd, force) {
     const { root } = detectProjectRoot(cwd);
     const sharkcraftDir = nodePath.join(root, 'sharkcraft');
@@ -212,6 +231,10 @@ function applyLegacyInit(cwd, force) {
         for (const s of skipped)
             process.stdout.write(bullet(s) + '\n');
     }
+    const legacyAdvisory = annotatePathsAgainstDisk(cwd, sharkcraftDir);
+    if (legacyAdvisory.annotated) {
+        renderPathsAdvisory(legacyAdvisory);
+    }
     process.stdout.write('\nNext:\n');
     process.stdout.write(bullet('Run `shrk inspect` to see your project summary.') + '\n');
     process.stdout.write(bullet('Run `shrk knowledge list` to see what was seeded.') + '\n');

package/dist/init/init-templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/init/init-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EA4Z1C,CAAC"}
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../../src/init/init-templates.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EA2W1C,CAAC"}

package/dist/init/init-templates.js

@@ -1,9 +1,18 @@
+// Self-contained scaffolding for `shrk init --legacy`. Every generated
+// `sharkcraft/*.ts` file must work in a brand-new downstream repo where
+// no `@shrkcrft/*` packages are installed beyond the CLI itself. The
+// loaders (knowledge / templates / pipelines / path-conventions) are
+// shape-agnostic — they accept any object with the required string
+// fields — so each emitted file declares its own minimal helpers +
+// enum-like constants inline.
 export const INIT_FILES = [
     {
         relativePath: 'sharkcraft.config.ts',
-        content: `import { defineSharkCraftConfig } from '@shrkcrft/config';
+        content: `// Generated by \`shrk init --legacy\`. Plain default export — no
+// @shrkcrft/* import required. The config loader validates this object
+// by shape (zod), so the literal works without a helper call.
 
-export default defineSharkCraftConfig({
+export default {
   projectName: 'my-project',
   description: 'A SharkCraft-powered repository.',
   knowledgeFiles: ['knowledge.ts'],
@@ -13,12 +22,36 @@ export default defineSharkCraftConfig({
   docsFiles: ['docs/overview.md', 'docs/architecture.md', 'docs/quick-start.md'],
   defaultMaxTokens: 4000,
   defaultScope: ['typescript'],
-});
+};
 `,
     },
     {
         relativePath: 'knowledge.ts',
-        content: `import { defineKnowledgeEntry, KnowledgeType, KnowledgePriority } from '@shrkcrft/knowledge';
+        content: `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+// The knowledge loader is shape-agnostic; it accepts any object whose
+// \`id\`, \`title\`, and \`content\` are strings.
+
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = {
+  Rule: 'rule',
+  Path: 'path',
+  Template: 'template',
+  Architecture: 'architecture',
+  Technical: 'technical',
+  Convention: 'convention',
+  Workflow: 'workflow',
+  Warning: 'warning',
+} as const;
+
+function defineKnowledgeEntry<T>(entry: T): T {
+  return entry;
+}
 
 export const projectOverview = defineKnowledgeEntry({
   id: 'project.overview',
@@ -67,8 +100,20 @@ export default [projectOverview, aiAgentBriefing, generationSafety];
     },
     {
         relativePath: 'rules.ts',
-        content: `import { defineRule } from '@shrkcrft/rules';
-import { KnowledgePriority } from '@shrkcrft/knowledge';
+        content: `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = { Rule: 'rule' } as const;
+
+function defineRule<T>(rule: T): T {
+  return { ...rule, type: KnowledgeType.Rule } as T;
+}
 
 export const tsNamingClasses = defineRule({
   id: 'typescript.naming.classes',
@@ -142,81 +187,15 @@ export default [
     },
     {
         relativePath: 'paths.ts',
-        content: `import { definePathConvention } from '@shrkcrft/paths';
-import { KnowledgePriority } from '@shrkcrft/knowledge';
-
-export const appSrc = definePathConvention({
-  id: 'app.src',
-  title: 'Application source root',
-  path: 'src',
-  description: 'All application source lives here.',
-  priority: KnowledgePriority.Critical,
-  scope: ['typescript'],
-  tags: ['source-path', 'root'],
-  appliesWhen: ['generate-code'],
-});
-
-export const services = definePathConvention({
-  id: 'app.services',
-  title: 'Application services',
-  path: 'src/services',
-  description: 'Application services live here.',
-  priority: KnowledgePriority.High,
-  scope: ['typescript', 'backend'],
-  tags: ['service', 'source-path'],
-  appliesWhen: ['generate-service', 'create-business-logic'],
-});
-
-export const utils = definePathConvention({
-  id: 'app.utils',
-  title: 'Utilities',
-  path: 'src/utils',
-  description: 'Pure functions, no side effects.',
-  priority: KnowledgePriority.Medium,
-  scope: ['typescript'],
-  tags: ['util', 'source-path'],
-  appliesWhen: ['generate-utility'],
-});
-
-export const features = definePathConvention({
-  id: 'app.features',
-  title: 'Feature folders',
-  path: 'src/features',
-  description: 'Vertical feature slices. Use this for end-to-end features.',
-  priority: KnowledgePriority.Medium,
-  scope: ['typescript'],
-  tags: ['feature', 'source-path'],
-  appliesWhen: ['generate-feature'],
-});
-
-export const tests = definePathConvention({
-  id: 'app.tests',
-  title: 'Test files',
-  path: 'tests',
-  description: 'Test files (or co-located *.spec.ts next to the unit under test).',
-  priority: KnowledgePriority.Medium,
-  scope: ['typescript', 'testing'],
-  tags: ['test', 'source-path'],
-  appliesWhen: ['generate-test'],
-});
-
-export const docs = definePathConvention({
-  id: 'app.docs',
-  title: 'Documentation',
-  path: 'docs',
-  description: 'Long-form human-readable docs (optional).',
-  priority: KnowledgePriority.Low,
-  scope: ['typescript'],
-  tags: ['docs'],
-  appliesWhen: ['add-docs'],
-});
-
-export default [appSrc, services, utils, features, tests, docs];
-`,
+        content: PATHS_PLACEHOLDER_CONTENT(),
     },
     {
         relativePath: 'templates.ts',
-        content: `import { defineTemplate } from '@shrkcrft/templates';
+        content: `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+
+function defineTemplate<T>(template: T): T {
+  return template;
+}
 
 export const tsService = defineTemplate({
   id: 'typescript.service',
@@ -229,8 +208,8 @@ export const tsService = defineTemplate({
     { name: 'name', required: true, description: 'kebab-case file name (e.g. user-profile)' },
     { name: 'className', required: true, description: 'PascalCase class name (e.g. UserProfileService)' },
   ],
-  targetPath: ({ name }) => \`src/services/\${name}.service.ts\`,
-  content: ({ className }) => \`export class \${className} {
+  targetPath: ({ name }: { name: string }) => \`src/services/\${name}.service.ts\`,
+  content: ({ className }: { className: string }) => \`export class \${className} {
   constructor() {}
 
   init(): void {
@@ -253,42 +232,14 @@ export const tsUtility = defineTemplate({
     { name: 'name', required: true, description: 'kebab-case file name' },
     { name: 'camel', required: true, description: 'camelCase function name' },
   ],
-  targetPath: ({ name }) => \`src/utils/\${name}.ts\`,
-  content: ({ camel }) => \`export function \${camel}(input: unknown): unknown {
+  targetPath: ({ name }: { name: string }) => \`src/utils/\${name}.ts\`,
+  content: ({ camel }: { camel: string }) => \`export function \${camel}(input: unknown): unknown {
   return input;
 }
 \`,
   postGenerationNotes: ['Keep utilities pure. No side effects, no shared mutable state.'],
 });
 
-export const tsFeatureFolder = defineTemplate({
-  id: 'typescript.feature',
-  name: 'TypeScript Feature folder',
-  description: 'Creates a vertical feature slice (index + service + types).',
-  tags: ['typescript', 'feature'],
-  scope: ['typescript'],
-  appliesWhen: ['generate-feature'],
-  variables: [
-    { name: 'name', required: true },
-    { name: 'pascal', required: true },
-  ],
-  files: ({ name, pascal }) => [
-    {
-      targetPath: \`src/features/\${name}/index.ts\`,
-      content: \`export * from './\${name}.service.ts';\nexport * from './\${name}.types.ts';\n\`,
-    },
-    {
-      targetPath: \`src/features/\${name}/\${name}.service.ts\`,
-      content: \`import type { I\${pascal}Config } from './\${name}.types.ts';\n\nexport class \${pascal}Service {\n  constructor(private readonly config: I\${pascal}Config) {}\n}\n\`,
-    },
-    {
-      targetPath: \`src/features/\${name}/\${name}.types.ts\`,
-      content: \`export interface I\${pascal}Config {\n  enabled: boolean;\n}\n\`,
-    },
-  ],
-  postGenerationNotes: ['Add tests under tests/<feature> or co-located *.spec.ts.'],
-});
-
 export const tsTest = defineTemplate({
   id: 'typescript.test',
   name: 'TypeScript Test File',
@@ -300,11 +251,18 @@ export const tsTest = defineTemplate({
     { name: 'name', required: true },
     { name: 'pascal', required: true },
   ],
-  targetPath: ({ name }) => \`tests/\${name}.spec.ts\`,
-  content: ({ pascal }) => \`import { describe, expect, test } from 'bun:test';\n\ndescribe('\${pascal}', () => {\n  test('placeholder', () => {\n    expect(true).toBe(true);\n  });\n});\n\`,
+  targetPath: ({ name }: { name: string }) => \`tests/\${name}.spec.ts\`,
+  content: ({ pascal }: { pascal: string }) => \`import { describe, expect, test } from 'bun:test';
+
+describe('\${pascal}', () => {
+  test('placeholder', () => {
+    expect(true).toBe(true);
+  });
+});
+\`,
 });
 
-export default [tsService, tsUtility, tsFeatureFolder, tsTest];
+export default [tsService, tsUtility, tsTest];
 `,
     },
     {
@@ -411,3 +369,65 @@ Lower-priority work for SharkCraft-powered knowledge in this repo.
 `,
     },
 ];
+function PATHS_PLACEHOLDER_CONTENT() {
+    // The legacy seed ships generic path examples. The modern preset path
+    // (`shrk init --preset <id>`) is workspace-aware. To avoid emitting
+    // broken defaults like `src/services/` in repos that don't have them,
+    // the legacy seed now ships *commented* examples plus an `// TODO:`
+    // marker the human is expected to fill in. The runner-instructions in
+    // docs/onboarding.md describe how to derive paths from the live repo.
+    return `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = { Path: 'path' } as const;
+
+function definePathConvention<T>(convention: T): T {
+  return { ...convention, type: KnowledgeType.Path } as T;
+}
+
+// TODO: replace the examples below with real path conventions for this
+// repository. Run \`shrk onboard --dry-run\` to see what the inference
+// engine detects from the workspace.
+
+export const appSrc = definePathConvention({
+  id: 'app.src',
+  title: 'Application source root',
+  path: 'src',
+  description: 'All application source lives here. Adjust to match this repo.',
+  priority: KnowledgePriority.Critical,
+  scope: ['typescript'],
+  tags: ['source-path', 'root'],
+  appliesWhen: ['generate-code'],
+});
+
+export const tests = definePathConvention({
+  id: 'app.tests',
+  title: 'Test files',
+  path: 'tests',
+  description: 'Test files. Many repos co-locate \`*.spec.ts\` next to the unit under test instead — pick one.',
+  priority: KnowledgePriority.Medium,
+  scope: ['typescript', 'testing'],
+  tags: ['test', 'source-path'],
+  appliesWhen: ['generate-test'],
+});
+
+export const docs = definePathConvention({
+  id: 'app.docs',
+  title: 'Documentation',
+  path: 'docs',
+  description: 'Long-form human-readable docs (optional).',
+  priority: KnowledgePriority.Low,
+  scope: ['typescript'],
+  tags: ['docs'],
+  appliesWhen: ['add-docs'],
+});
+
+export default [appSrc, tests, docs];
+`;
+}

package/dist/init/paths-advisory.d.ts

@@ -0,0 +1,20 @@
+export interface IPathsAdvisory {
+    missingPaths: readonly string[];
+    existingPaths: readonly string[];
+    /** True when an advisory comment was prepended to the file. */
+    annotated: boolean;
+    pathsFile: string;
+}
+/**
+ * Scan the generated `sharkcraft/paths.ts` for `path: '<x>'` references
+ * and check each `<x>` against the live workspace. When any path is
+ * missing, prepend a clearly-labeled comment block listing the missing
+ * paths so the user knows which defaults to adjust.
+ *
+ * Idempotent — if the file already starts with the advisory marker,
+ * it is left untouched. Non-destructive — never edits, comments, or
+ * removes the original entries. The user is expected to revise them
+ * based on the advisory + `shrk onboard --dry-run` output.
+ */
+export declare function annotatePathsAgainstDisk(cwd: string, sharkcraftDir: string): IPathsAdvisory;
+//# sourceMappingURL=paths-advisory.d.ts.map

package/dist/init/paths-advisory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-advisory.d.ts","sourceRoot":"","sources":["../../src/init/paths-advisory.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,GACpB,cAAc,CAwChB"}

package/dist/init/paths-advisory.js

@@ -0,0 +1,88 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+const ADVISORY_MARKER = '// ⚠️ Workspace-shape advisory (added by `shrk init`):';
+/**
+ * Scan the generated `sharkcraft/paths.ts` for `path: '<x>'` references
+ * and check each `<x>` against the live workspace. When any path is
+ * missing, prepend a clearly-labeled comment block listing the missing
+ * paths so the user knows which defaults to adjust.
+ *
+ * Idempotent — if the file already starts with the advisory marker,
+ * it is left untouched. Non-destructive — never edits, comments, or
+ * removes the original entries. The user is expected to revise them
+ * based on the advisory + `shrk onboard --dry-run` output.
+ */
+export function annotatePathsAgainstDisk(cwd, sharkcraftDir) {
+    const pathsFile = nodePath.join(sharkcraftDir, 'paths.ts');
+    if (!existsSync(pathsFile)) {
+        return { missingPaths: [], existingPaths: [], annotated: false, pathsFile };
+    }
+    const original = readFileSync(pathsFile, 'utf8');
+    if (original.startsWith(ADVISORY_MARKER)) {
+        // Already annotated. Re-derive sets for caller diagnostics.
+        return classifyOnly(cwd, pathsFile, original);
+    }
+    const { existing, missing } = classifyPathReferences(cwd, original);
+    if (missing.length === 0) {
+        return {
+            missingPaths: [],
+            existingPaths: existing,
+            annotated: false,
+            pathsFile,
+        };
+    }
+    const lines = [
+        ADVISORY_MARKER,
+        '//',
+        '// The following paths referenced below do NOT exist in this repository:',
+        ...missing.map((p) => `//   - ${p}`),
+        '//',
+        '// They are conservative defaults from the chosen preset. Adjust them to',
+        '// match your actual layout. Run `shrk onboard --dry-run` to see what',
+        '// the inference engine detects from your workspace.',
+        '//',
+        '',
+    ];
+    writeFileSync(pathsFile, lines.join('\n') + original, 'utf8');
+    return {
+        missingPaths: missing,
+        existingPaths: existing,
+        annotated: true,
+        pathsFile,
+    };
+}
+function classifyOnly(cwd, pathsFile, original) {
+    const { existing, missing } = classifyPathReferences(cwd, original);
+    return {
+        missingPaths: missing,
+        existingPaths: existing,
+        annotated: false,
+        pathsFile,
+    };
+}
+function classifyPathReferences(cwd, source) {
+    // Match `path: '<x>'` / `path: "<x>"`. Ignore obvious code-context
+    // references (e.g. inside template literals); we only consume the
+    // first plain-string occurrence per entry.
+    const re = /\bpath\s*:\s*['"]([^'"\n]+)['"]/g;
+    const seen = new Set();
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        if (m[1])
+            seen.add(m[1]);
+    }
+    const existing = [];
+    const missing = [];
+    for (const p of [...seen].sort()) {
+        if (isReachable(cwd, p))
+            existing.push(p);
+        else
+            missing.push(p);
+    }
+    return { existing, missing };
+}
+function isReachable(cwd, p) {
+    // Absolute or rooted-relative — resolve as-is.
+    const full = nodePath.isAbsolute(p) ? p : nodePath.resolve(cwd, p);
+    return existsSync(full);
+}

package/dist/surface/surface-config-writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-config-writer.d.ts","sourceRoot":"","sources":["../../src/surface/surface-config-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,kBAAkB,CA0BpB;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,GACvB,yBAAyB,CAe3B;AAmBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAO,GAAG,MAAM,CAsBjF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAgBtF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/D"}
+{"version":3,"file":"surface-config-writer.d.ts","sourceRoot":"","sources":["../../src/surface/surface-config-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACrC,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,kBAAkB,CA0BpB;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,kBAAkB,GACvB,yBAAyB,CAe3B;AAoBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,SAAO,GAAG,MAAM,CAsBjF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CA6BtF;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE/D"}

package/dist/surface/surface-config-writer.js

@@ -72,10 +72,11 @@ function fileExists(p) {
         return false;
     }
 }
-const DEFAULT_CONFIG_BODY = `import { defineSharkCraftConfig } from '@shrkcrft/config';
-
-export default defineSharkCraftConfig({
-});
+// Plain default export — no @shrkcrft/* import required. The config
+// loader (packages/config/src/config-loader.ts) validates by shape, so a
+// literal object works the same as a `defineSharkCraftConfig()` call.
+const DEFAULT_CONFIG_BODY = `export default {
+};
 `;
 const SURFACE_BLOCK_REGEX = /(^\s*surface\s*:\s*\{[\s\S]*?\}\s*,?\s*\n)/m;
 /**
@@ -120,14 +121,25 @@ export function applySurfaceTextEdit(original, surface) {
     if (SURFACE_BLOCK_REGEX.test(original)) {
         return original.replace(SURFACE_BLOCK_REGEX, block);
     }
-    // Insert before the closing `})` / `});` of the config object.
-    // Prefer the last `})` so nested objects don't trip us up.
-    const closeRegex = /(\n)(\}\)\s*;?\s*)$/m;
-    if (closeRegex.test(original)) {
-        return original.replace(closeRegex, `\n${block}$2`);
+    // (A) `defineSharkCraftConfig({ ... })` style — insert before the `})`.
+    const closeFn = /(\n)(\}\)\s*;?\s*)$/m;
+    if (closeFn.test(original)) {
+        return original.replace(closeFn, `\n${block}$2`);
     }
-    // Fallback: append at end with a defineSharkCraftConfig wrapper.
-    return `${original}\n${DEFAULT_CONFIG_BODY.replace('})', `${block}})`)}`;
+    // (B) `const config = { ... };\nexport default config;` plain style —
+    // insert before the `};` that closes the literal.
+    const closePlain = /(\n)(\};?\s*\nexport\s+default\s+\w+\s*;?\s*\n*)$/m;
+    if (closePlain.test(original)) {
+        return original.replace(closePlain, `\n${block}$2`);
+    }
+    // (C) `export default { ... };` direct style — insert before the `};`.
+    const closeDirect = /(\n)(\};?\s*\n*)$/m;
+    if (closeDirect.test(original)) {
+        return original.replace(closeDirect, `\n${block}$2`);
+    }
+    // Fallback: append at end with a plain default-exported config (no
+    // `@shrkcrft/*` import required).
+    return `${original}\n${DEFAULT_CONFIG_BODY.replace('};', `${block}};`)}`;
 }
 /** Default config file path for a project. */
 export function defaultConfigFile(sharkcraftDir) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/cli",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "SharkCraft CLI (`shrk`): structured project intelligence for AI coding agents.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -47,25 +47,25 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.2",
-    "@shrkcrft/config": "^0.1.0-alpha.2",
-    "@shrkcrft/workspace": "^0.1.0-alpha.2",
-    "@shrkcrft/knowledge": "^0.1.0-alpha.2",
-    "@shrkcrft/context": "^0.1.0-alpha.2",
-    "@shrkcrft/rules": "^0.1.0-alpha.2",
-    "@shrkcrft/paths": "^0.1.0-alpha.2",
-    "@shrkcrft/templates": "^0.1.0-alpha.2",
-    "@shrkcrft/plugin-api": "^0.1.0-alpha.2",
-    "@shrkcrft/dashboard-api": "^0.1.0-alpha.2",
-    "@shrkcrft/pipelines": "^0.1.0-alpha.2",
-    "@shrkcrft/presets": "^0.1.0-alpha.2",
-    "@shrkcrft/boundaries": "^0.1.0-alpha.2",
-    "@shrkcrft/generator": "^0.1.0-alpha.2",
-    "@shrkcrft/importer": "^0.1.0-alpha.2",
-    "@shrkcrft/inspector": "^0.1.0-alpha.2",
-    "@shrkcrft/ai": "^0.1.0-alpha.2",
-    "@shrkcrft/shared": "^0.1.0-alpha.2",
-    "@shrkcrft/mcp-server": "^0.1.0-alpha.2"
+    "@shrkcrft/core": "^0.1.0-alpha.4",
+    "@shrkcrft/config": "^0.1.0-alpha.4",
+    "@shrkcrft/workspace": "^0.1.0-alpha.4",
+    "@shrkcrft/knowledge": "^0.1.0-alpha.4",
+    "@shrkcrft/context": "^0.1.0-alpha.4",
+    "@shrkcrft/rules": "^0.1.0-alpha.4",
+    "@shrkcrft/paths": "^0.1.0-alpha.4",
+    "@shrkcrft/templates": "^0.1.0-alpha.4",
+    "@shrkcrft/plugin-api": "^0.1.0-alpha.4",
+    "@shrkcrft/dashboard-api": "^0.1.0-alpha.4",
+    "@shrkcrft/pipelines": "^0.1.0-alpha.4",
+    "@shrkcrft/presets": "^0.1.0-alpha.4",
+    "@shrkcrft/boundaries": "^0.1.0-alpha.4",
+    "@shrkcrft/generator": "^0.1.0-alpha.4",
+    "@shrkcrft/importer": "^0.1.0-alpha.4",
+    "@shrkcrft/inspector": "^0.1.0-alpha.4",
+    "@shrkcrft/ai": "^0.1.0-alpha.4",
+    "@shrkcrft/shared": "^0.1.0-alpha.4",
+    "@shrkcrft/mcp-server": "^0.1.0-alpha.4"
   },
   "publishConfig": {
     "access": "public"