@shrkcrft/cli 0.1.0-alpha.7 → 0.1.0-alpha.9

package/dist/commands/packs.command.js

@@ -1,10 +1,18 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import * as nodePath from 'node:path';
+import { pathToFileURL } from 'node:url';
 import { buildPackDoctorReport, buildPackSignatureStatusReport, checkPackSymbolCompat, explainPackSignatureStatus, inspectSharkcraft, mergePackReleaseChecks, runPackReleaseCheck, runPackReleaseChecksForReport, } from '@shrkcrft/inspector';
 import { PACK_SECRET_ENV, signPackManifest, validatePackManifest, verifyPackManifest, } from '@shrkcrft/plugin-api';
 import { flagBool, flagString, resolveCwd, } from "../command-registry.js";
 import { asJson, header, kv } from "../output/format-output.js";
-import { importModuleViaLoader } from '@shrkcrft/core';
 function statusLabel(valid) {
     return valid ? 'OK     ' : 'INVALID';
 }
@@ -545,7 +553,7 @@ async function loadManifestFromPath(manifestPath) {
     if (manifestPath.endsWith('.json')) {
         return JSON.parse(readFileSync(manifestPath, 'utf8'));
     }
-    const mod = (await importModuleViaLoader(manifestPath));
+    const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(manifestPath).href)));
     return (mod.default ?? mod);
 }
 export const packsSignCommand = {
@@ -765,11 +773,17 @@ export const packsCompatCommand = {
                 : nodePath.resolve(cwd, consumerRootRaw)
             : null;
         const distAware = flagBool(args, 'dist-aware');
+        const fastMode = flagBool(args, 'fast');
         // Run a release-check first; surfaces helper-missing diagnostics.
         const release = await runPackReleaseCheck(abs);
         const helperMissing = release.findings.filter((f) => f.code === 'contribution-helper-missing');
         // Symbol-level diff against the consumer's installed plugin-api.
-        const symbol = checkPackSymbolCompat({ packPath: abs, consumerRoot, distAware });
+        const symbol = checkPackSymbolCompat({
+            packPath: abs,
+            consumerRoot,
+            distAware,
+            mode: fastMode ? 'fast' : 'ts',
+        });
         const passed = helperMissing.length === 0 && symbol.compatible;
         if (flagBool(args, 'json')) {
             process.stdout.write(asJson({

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

@@ -1 +1 @@
-{"version":3,"file":"review.command.d.ts","sourceRoot":"","sources":["../../src/commands/review.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA6GhC,eAAO,MAAM,aAAa,EAAE,eA+E3B,CAAC"}
+{"version":3,"file":"review.command.d.ts","sourceRoot":"","sources":["../../src/commands/review.command.ts"],"names":[],"mappings":"AAgBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA6GhC,eAAO,MAAM,aAAa,EAAE,eA8F3B,CAAC"}

package/dist/commands/review.command.js

@@ -95,8 +95,21 @@ export const reviewCommand = {
         if (args.positional[0] === 'packet') {
             return runPacket(args);
         }
-        const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
+        const cwd = resolveCwd(args);
+        const inspection = await inspectSharkcraft({ cwd });
         const since = flagString(args, 'since');
+        if (since) {
+            const { verifyGitRef } = await import('@shrkcrft/inspector');
+            const verify = verifyGitRef(cwd, since);
+            if (!verify.valid) {
+                process.stderr.write(`error: --since ref "${since}" does not resolve to a commit in this repository.\n` +
+                    (verify.suggestions && verify.suggestions.length > 0
+                        ? `\nDid you mean:\n${verify.suggestions.map((s) => `  --since ${s}`).join('\n')}\n`
+                        : '') +
+                    '\nUse `git branch -a` to list available refs.\n');
+                return 2;
+            }
+        }
         const files = flagList(args, 'files');
         const packet = buildReviewPacket(inspection, {
             ...(since ? { since } : {}),
@@ -295,8 +308,21 @@ function isReviewPacketV3Shape(v) {
     return v.schema === REVIEW_PACKET_V3_SCHEMA;
 }
 async function runPacket(args) {
-    const inspection = await inspectSharkcraft({ cwd: resolveCwd(args) });
+    const cwd = resolveCwd(args);
+    const inspection = await inspectSharkcraft({ cwd });
     const since = flagString(args, 'since');
+    if (since) {
+        const { verifyGitRef } = await import('@shrkcrft/inspector');
+        const verify = verifyGitRef(cwd, since);
+        if (!verify.valid) {
+            process.stderr.write(`error: --since ref "${since}" does not resolve to a commit in this repository.\n` +
+                (verify.suggestions && verify.suggestions.length > 0
+                    ? `\nDid you mean:\n${verify.suggestions.map((s) => `  --since ${s}`).join('\n')}\n`
+                    : '') +
+                '\nUse `git branch -a` to list available refs.\n');
+            return 2;
+        }
+    }
     const files = flagList(args, 'files');
     const v2 = flagBool(args, 'v2');
     const baselineFile = flagString(args, 'quality-baseline');

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;AAUD,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EA2W1C,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;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EA4Z1C,CAAC"}

package/dist/init/init-templates.js

@@ -1,18 +1,9 @@
-// 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: `// 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.
+        content: `import { defineSharkCraftConfig } from '@shrkcrft/config';
 
-export default {
+export default defineSharkCraftConfig({
   projectName: 'my-project',
   description: 'A SharkCraft-powered repository.',
   knowledgeFiles: ['knowledge.ts'],
@@ -22,36 +13,12 @@ export default {
   docsFiles: ['docs/overview.md', 'docs/architecture.md', 'docs/quick-start.md'],
   defaultMaxTokens: 4000,
   defaultScope: ['typescript'],
-};
+});
 `,
     },
     {
         relativePath: 'knowledge.ts',
-        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;
-}
+        content: `import { defineKnowledgeEntry, KnowledgeType, KnowledgePriority } from '@shrkcrft/knowledge';
 
 export const projectOverview = defineKnowledgeEntry({
   id: 'project.overview',
@@ -100,20 +67,8 @@ export default [projectOverview, aiAgentBriefing, generationSafety];
     },
     {
         relativePath: 'rules.ts',
-        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;
-}
+        content: `import { defineRule } from '@shrkcrft/rules';
+import { KnowledgePriority } from '@shrkcrft/knowledge';
 
 export const tsNamingClasses = defineRule({
   id: 'typescript.naming.classes',
@@ -187,15 +142,81 @@ export default [
     },
     {
         relativePath: 'paths.ts',
-        content: PATHS_PLACEHOLDER_CONTENT(),
+        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];
+`,
     },
     {
         relativePath: 'templates.ts',
-        content: `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
-
-function defineTemplate<T>(template: T): T {
-  return template;
-}
+        content: `import { defineTemplate } from '@shrkcrft/templates';
 
 export const tsService = defineTemplate({
   id: 'typescript.service',
@@ -208,8 +229,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 }: { name: string }) => \`src/services/\${name}.service.ts\`,
-  content: ({ className }: { className: string }) => \`export class \${className} {
+  targetPath: ({ name }) => \`src/services/\${name}.service.ts\`,
+  content: ({ className }) => \`export class \${className} {
   constructor() {}
 
   init(): void {
@@ -232,14 +253,42 @@ export const tsUtility = defineTemplate({
     { name: 'name', required: true, description: 'kebab-case file name' },
     { name: 'camel', required: true, description: 'camelCase function name' },
   ],
-  targetPath: ({ name }: { name: string }) => \`src/utils/\${name}.ts\`,
-  content: ({ camel }: { camel: string }) => \`export function \${camel}(input: unknown): unknown {
+  targetPath: ({ name }) => \`src/utils/\${name}.ts\`,
+  content: ({ camel }) => \`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',
@@ -251,18 +300,11 @@ export const tsTest = defineTemplate({
     { name: 'name', required: true },
     { name: 'pascal', required: true },
   ],
-  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);
-  });
-});
-\`,
+  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\`,
 });
 
-export default [tsService, tsUtility, tsTest];
+export default [tsService, tsUtility, tsFeatureFolder, tsTest];
 `,
     },
     {
@@ -369,65 +411,3 @@ 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/main.d.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 import { CommandRegistry } from './command-registry.js';
 export declare function buildRegistry(): CommandRegistry;
 export declare function runCli(argv: readonly string[]): Promise<number>;

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EACL,eAAe,EAIhB,MAAM,uBAAuB,CAAC;AAyV/B,wBAAgB,aAAa,IAAI,eAAe,CA2V/C;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE;AA6FD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA4CxE"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EACL,eAAe,EAIhB,MAAM,uBAAuB,CAAC;AAqX/B,wBAAgB,aAAa,IAAI,eAAe,CA2V/C;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BrE;AAqGD;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CA4CxE"}

package/dist/main.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
 import { CommandRegistry, extractGlobalCwd, parseArgs, } from "./command-registry.js";
 import { initCommand } from "./commands/init.command.js";
 import { inspectCommand } from "./commands/inspect.command.js";
@@ -120,6 +120,33 @@ import { buildSurfaceSummary, findCommandInSummary } from "./surface/surface-sum
 import { makeSurfaceNotEnabledError, renderSurfaceNotEnabledText, SURFACE_NOT_ENABLED_EXIT_CODE, } from "./surface/not-enabled-error.js";
 import { extractCommandPath, recordUsage, sanitizeFlagNames, } from "./usage/usage-log.js";
 import { loadProjectConfig } from '@shrkcrft/config';
+import { initTokenizer } from '@shrkcrft/context';
+import { statSync } from 'node:fs';
+import { resolve as resolvePath } from 'node:path';
+function isUsableDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+let tokenizerInitPromise = null;
+/**
+ * Best-effort one-time upgrade from the estimator to gpt-tokenizer.
+ *
+ * The estimator is always active before this resolves, so commands that
+ * race the load still get a budget-safe (if slightly off) count. Subsequent
+ * `countTokens` calls get the real BPE count.
+ */
+async function ensureTokenizerReady() {
+    if (process.env.SHARKCRAFT_NO_REAL_TOKENIZER === '1')
+        return;
+    if (!tokenizerInitPromise) {
+        tokenizerInitPromise = initTokenizer().catch(() => false);
+    }
+    await tokenizerInitPromise;
+}
 export function buildRegistry() {
     const registry = new CommandRegistry();
     registry.register(initCommand);
@@ -491,9 +518,15 @@ async function isUsageEnabled(cwd) {
     }
 }
 async function runCliInner(argv) {
+    await ensureTokenizerReady();
     const registry = buildRegistry();
     // Pre-parse the global --cwd so it can appear anywhere (incl. before the command).
     const { cwd: globalCwd, rest: cleanArgv } = extractGlobalCwd(argv);
+    if (globalCwd !== undefined && !isUsableDirectory(globalCwd)) {
+        process.stderr.write(`error: --cwd "${globalCwd}" is not an existing directory.\n` +
+            `Resolved to: ${resolvePath(globalCwd)}\n`);
+        return 2;
+    }
     const [first] = cleanArgv;
     // bare invocation lands on the curated tiered view.
     if (!first) {
@@ -678,19 +711,8 @@ function printDidYouMean(attempted) {
         process.stderr.write(renderErrorFooter(footer));
 }
 // Entry point when invoked directly.
-//
-// Bun exposes `import.meta.main`; Node does not. When Node runs the
-// compiled `dist/main.js` directly the path-suffix check (`main.js`)
-// catches it. The npm bin shim points at `shrk` so that suffix also
-// triggers it. Source dev under Bun still runs via `main.ts`.
 const isMain = typeof import.meta !== 'undefined' && import.meta.main === true;
-const entryPath = process.argv[1] ?? '';
-if (isMain ||
-    entryPath.endsWith('main.ts') ||
-    entryPath.endsWith('main.js') ||
-    entryPath.endsWith('shrk') ||
-    entryPath.endsWith('shrk.js') ||
-    entryPath.endsWith('shrk.cmd')) {
+if (isMain || process.argv[1]?.endsWith('main.ts') || process.argv[1]?.endsWith('shrk')) {
     const argv = process.argv.slice(2);
     runCli(argv).then((code) => process.exit(code), (err) => {
         process.stderr.write(`Fatal: ${err instanceof Error ? err.message : String(err)}\n`);

package/dist/output/failure-hints.d.ts

@@ -12,7 +12,15 @@ export interface IFailureHint {
     doc?: string;
 }
 export declare function renderFailureHints(hints: readonly IFailureHint[]): string;
-export declare function doctorHints(): IFailureHint[];
+export interface IDoctorHintsContext {
+    /**
+     * True when the workspace has no `sharkcraft/` folder. On a fresh repo
+     * the right next step is `shrk init`, not advanced suppressions/watch
+     * loops.
+     */
+    sharkcraftFolderMissing?: boolean;
+}
+export declare function doctorHints(context?: IDoctorHintsContext): IFailureHint[];
 export declare function staleKnowledgeHints(): IFailureHint[];
 export declare function templateDriftHints(): IFailureHint[];
 export declare function fuzzyImpactAmbiguousHints(): IFailureHint[];

package/dist/output/failure-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"failure-hints.d.ts","sourceRoot":"","sources":["../../src/output/failure-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAUzE;AAID,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAM5C;AAED,wBAAgB,mBAAmB,IAAI,YAAY,EAAE,CAMpD;AAED,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAMnD;AAED,wBAAgB,yBAAyB,IAAI,YAAY,EAAE,CAK1D;AAED,wBAAgB,6BAA6B,IAAI,YAAY,EAAE,CAK9D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAKnD;AAED,wBAAgB,wBAAwB,IAAI,YAAY,EAAE,CAKzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiB9D;AAED,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,GAClB,eAAe,GACf,2BAA2B,GAC3B,sBAAsB,GACtB,+BAA+B,GAC/B,wBAAwB,GACxB,8BAA8B,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,GAAG,SAAS,CA4E3G"}
+{"version":3,"file":"failure-hints.d.ts","sourceRoot":"","sources":["../../src/output/failure-hints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAUzE;AAID,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,EAAE,CAa7E;AAED,wBAAgB,mBAAmB,IAAI,YAAY,EAAE,CAMpD;AAED,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAMnD;AAED,wBAAgB,yBAAyB,IAAI,YAAY,EAAE,CAK1D;AAED,wBAAgB,6BAA6B,IAAI,YAAY,EAAE,CAK9D;AAED,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAKnD;AAED,wBAAgB,wBAAwB,IAAI,YAAY,EAAE,CAKzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiB9D;AAED,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,GAClB,eAAe,GACf,2BAA2B,GAC3B,sBAAsB,GACtB,+BAA+B,GAC/B,wBAAwB,GACxB,8BAA8B,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,GAAG,SAAS,CA4E3G"}

package/dist/output/failure-hints.js

@@ -11,8 +11,14 @@ export function renderFailureHints(hints) {
     }
     return lines.join('\n') + '\n';
 }
-// ── Convenience hint builders ──────────────────────────────────────────
-export function doctorHints() {
+export function doctorHints(context = {}) {
+    if (context.sharkcraftFolderMissing) {
+        return [
+            { label: 'scaffold sharkcraft/ (auto-pick a preset)', command: 'shrk init --zero-config' },
+            { label: 'preview the scaffold first', command: 'shrk init --zero-config --dry-run' },
+            { label: 'try the killer demo (no folder required)', command: 'shrk check boundaries --changed-only --since main' },
+        ];
+    }
     return [
         { label: 'preview fix suggestions', command: 'shrk fix preview --action-hints' },
         { label: 'list suppressions', command: 'shrk doctor suppressions list' },

package/dist/output/watch-loop.d.ts

@@ -27,19 +27,11 @@ export interface IWatchPlan {
 }
 export declare function buildWatchPlan(options: IWatchLoopOptions, steps: readonly string[]): IWatchPlan;
 import type { ParsedArgs } from '../command-registry.js';
-export interface IWatchModeOptions {
-    /**
-     * Paths to watch when the user does not pass `--paths`. Defaults to
-     * `['sharkcraft']` if omitted. Use this for commands that scan code
-     * outside `sharkcraft/` (e.g. `check boundaries` scans the whole repo).
-     */
-    defaultPaths?: readonly string[];
-}
 /**
  * Run a command's `run` function inside a watch loop when --watch is set.
  *
  * @returns null if --watch is not set (caller proceeds as before), otherwise
  * the exit code of the watch loop.
  */
-export declare function maybeRunInWatchMode(args: ParsedArgs, runner: (innerArgs: ParsedArgs) => Promise<number>, options?: IWatchModeOptions): Promise<number | null>;
+export declare function maybeRunInWatchMode(args: ParsedArgs, runner: (innerArgs: ParsedArgs) => Promise<number>): Promise<number | null>;
 //# sourceMappingURL=watch-loop.d.ts.map

package/dist/output/watch-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watch-loop.d.ts","sourceRoot":"","sources":["../../src/output/watch-loop.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6DjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,CAYZ;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,EAClD,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCxB"}
+{"version":3,"file":"watch-loop.d.ts","sourceRoot":"","sources":["../../src/output/watch-loop.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC,CA6DjB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,0BAA0B,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,UAAU,CAYZ;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,CAAC,SAAS,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GACjD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB"}

package/dist/output/watch-loop.js

@@ -81,41 +81,31 @@ export function buildWatchPlan(options, steps) {
         steps,
     };
 }
-import { flagBool, flagNumber, flagString, resolveCwd } from "../command-registry.js";
+import { flagBool, flagNumber, resolveCwd } from "../command-registry.js";
 /**
  * Run a command's `run` function inside a watch loop when --watch is set.
  *
  * @returns null if --watch is not set (caller proceeds as before), otherwise
  * the exit code of the watch loop.
  */
-export async function maybeRunInWatchMode(args, runner, options = {}) {
+export async function maybeRunInWatchMode(args, runner) {
     if (!flagBool(args, 'watch'))
         return null;
     const cwd = resolveCwd(args);
     const debounce = flagNumber(args, 'debounce') ?? 300;
     const once = flagBool(args, 'once');
-    const pathsFlag = flagString(args, 'paths');
-    const userPaths = pathsFlag
-        ? pathsFlag.split(',').map((s) => s.trim()).filter((s) => s.length > 0)
-        : [];
-    const paths = userPaths.length > 0
-        ? userPaths
-        : options.defaultPaths && options.defaultPaths.length > 0
-            ? options.defaultPaths
-            : ['sharkcraft'];
     // Strip --watch so the inner snapshot doesn't recurse.
     const innerFlags = new Map(args.flags);
     innerFlags.delete('watch');
     innerFlags.delete('once');
     innerFlags.delete('debounce');
-    innerFlags.delete('paths');
     const innerArgs = {
         positional: args.positional,
         flags: innerFlags,
         multiFlags: args.multiFlags,
         ...(args.globalCwd ? { globalCwd: args.globalCwd } : {}),
     };
-    return runWatchLoop({ cwd, debounce, once, paths }, {
+    return runWatchLoop({ cwd, debounce, once }, {
         snapshot: async () => {
             const ts = new Date().toLocaleTimeString();
             process.stdout.write(`\n[watch] ${ts}\n`);