@shrkcrft/config 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SharkCraft contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @shrkcrft/config
+
+SharkCraft config loader: sharkcraft.config.ts discovery, defaults, zod-validated schema.
+
+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
+
+```bash
+bun add @shrkcrft/config
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/config-loader.d.ts

@@ -0,0 +1,10 @@
+import { type AppError, type Result } from '@shrkcrft/core';
+import type { ISharkCraftConfig } from './sharkcraft-config.js';
+export interface LoadedConfig {
+    config: ISharkCraftConfig;
+    projectRoot: string;
+    sharkcraftDir: string;
+    configFile: string | null;
+}
+export declare function loadProjectConfig(startDir: string): Promise<Result<LoadedConfig, AppError>>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAID,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CA+DjG"}

package/dist/config-loader.js

@@ -0,0 +1,59 @@
+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 } from 'node:fs';
+import * as nodePath from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { AppErrorImpl, ERROR_CODES, err, ok } from '@shrkcrft/core';
+import { withDefaults } from "./default-config.js";
+import { detectProjectRoot, findSharkcraftDir } from "./project-config-resolver.js";
+import { SharkCraftConfigSchema } from "./config-schema.js";
+const CONFIG_FILE_CANDIDATES = ['sharkcraft.config.ts', 'sharkcraft.config.js', 'sharkcraft.config.mjs'];
+export async function loadProjectConfig(startDir) {
+    const projectInfo = detectProjectRoot(startDir);
+    const projectRoot = projectInfo.root;
+    const folder = findSharkcraftDir(projectRoot);
+    if (!folder) {
+        return err(new AppErrorImpl(ERROR_CODES.SHARKCRAFT_FOLDER_NOT_FOUND, `No sharkcraft/ folder found in ${projectRoot}`, { suggestion: 'Run `shrk init` to create one.', details: { projectRoot } }));
+    }
+    for (const candidate of CONFIG_FILE_CANDIDATES) {
+        const fullPath = nodePath.join(folder, candidate);
+        if (!existsSync(fullPath))
+            continue;
+        try {
+            const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(fullPath).href)));
+            const userConfig = (mod.default ?? mod) || {};
+            const parsed = SharkCraftConfigSchema.safeParse(userConfig);
+            if (!parsed.success) {
+                const summary = parsed.error.issues
+                    .map((iss) => `${iss.path.join('.') || '<root>'}: ${iss.message}`)
+                    .join('; ');
+                return err(new AppErrorImpl(ERROR_CODES.CONFIG_INVALID, `Invalid sharkcraft.config.ts: ${summary}`, {
+                    details: { fullPath, issues: parsed.error.issues },
+                    suggestion: 'Check the offending fields against ISharkCraftConfig.',
+                }));
+            }
+            return ok({
+                config: withDefaults(parsed.data),
+                projectRoot,
+                sharkcraftDir: folder,
+                configFile: fullPath,
+            });
+        }
+        catch (e) {
+            return err(new AppErrorImpl(ERROR_CODES.CONFIG_INVALID, `Failed to load config: ${fullPath}`, { details: { fullPath }, cause: e }));
+        }
+    }
+    // Fallback: no config file, use defaults
+    return ok({
+        config: withDefaults(null),
+        projectRoot,
+        sharkcraftDir: folder,
+        configFile: null,
+    });
+}

package/dist/config-schema.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Zod schema for sharkcraft.config.ts. Used by the loader and the doctor to
+ * surface clear errors for malformed configs. We don't replace ISharkCraftConfig
+ * with the inferred type because hand-written interfaces document intent better.
+ */
+export declare const SharkCraftConfigSchema: z.ZodObject<{
+    projectName: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    sharkcraftDir: z.ZodOptional<z.ZodString>;
+    knowledgeFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    docsFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    ruleFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pathFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    templateFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pipelineFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    defaultMaxTokens: z.ZodOptional<z.ZodNumber>;
+    defaultScope: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    actionHintDiagnostics: z.ZodOptional<z.ZodBoolean>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    presetFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    boundaryFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    contextTestFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    agentTestFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    verificationCommands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+        trusted: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    surface: z.ZodOptional<z.ZodObject<{
+        profile: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        hidden: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    usage: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SharkCraftConfigInput = z.infer<typeof SharkCraftConfigSchema>;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmDxB,CAAC;AAEZ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/config-schema.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+/**
+ * Zod schema for sharkcraft.config.ts. Used by the loader and the doctor to
+ * surface clear errors for malformed configs. We don't replace ISharkCraftConfig
+ * with the inferred type because hand-written interfaces document intent better.
+ */
+export const SharkCraftConfigSchema = z
+    .object({
+    projectName: z.string().optional(),
+    description: z.string().optional(),
+    sharkcraftDir: z.string().optional(),
+    knowledgeFiles: z.array(z.string()).optional(),
+    docsFiles: z.array(z.string()).optional(),
+    ruleFiles: z.array(z.string()).optional(),
+    pathFiles: z.array(z.string()).optional(),
+    templateFiles: z.array(z.string()).optional(),
+    pipelineFiles: z.array(z.string()).optional(),
+    defaultMaxTokens: z.number().int().positive().optional(),
+    defaultScope: z.array(z.string()).optional(),
+    actionHintDiagnostics: z.boolean().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    // Local registry extensions consumed by the inspector.
+    presetFiles: z.array(z.string()).optional(),
+    boundaryFiles: z.array(z.string()).optional(),
+    contextTestFiles: z.array(z.string()).optional(),
+    agentTestFiles: z.array(z.string()).optional(),
+    // Verification commands available to `shrk apply --validate --verification`.
+    verificationCommands: z
+        .array(z.object({
+        id: z.string(),
+        label: z.string().optional(),
+        command: z.string(),
+        trusted: z.boolean().optional(),
+    }))
+        .optional(),
+    // Adaptive surface gating.
+    surface: z
+        .object({
+        // Named profile (built-in or pack-contributed).
+        // Profile.hidden + profile.enabled merge with the explicit
+        // arrays below (config wins on conflicts).
+        profile: z.string().optional(),
+        enabled: z.array(z.string()).optional(),
+        hidden: z.array(z.string()).optional(),
+    })
+        .strict()
+        .optional(),
+    // Local usage log opt-out (default: enabled).
+    usage: z
+        .object({
+        enabled: z.boolean().optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict();

package/dist/config-validator.d.ts

@@ -0,0 +1,12 @@
+import type { ISharkCraftConfig } from './sharkcraft-config.js';
+export interface ConfigValidationIssue {
+    field: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface ConfigValidationResult {
+    valid: boolean;
+    issues: ConfigValidationIssue[];
+}
+export declare function validateConfig(config: ISharkCraftConfig): ConfigValidationResult;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../src/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,sBAAsB,CAuBhF"}

package/dist/config-validator.js

@@ -0,0 +1,20 @@
+export function validateConfig(config) {
+    const issues = [];
+    if (config.defaultMaxTokens !== undefined && config.defaultMaxTokens <= 0) {
+        issues.push({
+            field: 'defaultMaxTokens',
+            message: 'defaultMaxTokens must be > 0',
+            severity: 'error',
+        });
+    }
+    for (const field of ['knowledgeFiles', 'ruleFiles', 'pathFiles', 'templateFiles', 'docsFiles']) {
+        const v = config[field];
+        if (v !== undefined && !Array.isArray(v)) {
+            issues.push({ field, message: `${field} must be an array of strings`, severity: 'error' });
+        }
+    }
+    if (config.projectName !== undefined && typeof config.projectName !== 'string') {
+        issues.push({ field: 'projectName', message: 'projectName must be a string', severity: 'error' });
+    }
+    return { valid: issues.every((i) => i.severity !== 'error'), issues };
+}

package/dist/default-config.d.ts

@@ -0,0 +1,5 @@
+import { type ISharkCraftConfig } from './sharkcraft-config.js';
+export declare const DEFAULT_MAX_TOKENS = 4000;
+export declare function getDefaultConfig(): Required<Pick<ISharkCraftConfig, 'sharkcraftDir' | 'knowledgeFiles' | 'ruleFiles' | 'pathFiles' | 'templateFiles' | 'pipelineFiles' | 'docsFiles' | 'defaultMaxTokens' | 'defaultScope'>>;
+export declare function withDefaults(config: ISharkCraftConfig | null | undefined): ISharkCraftConfig;
+//# sourceMappingURL=default-config.d.ts.map

package/dist/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../src/default-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wBAAgB,gBAAgB,IAAI,QAAQ,CAC1C,IAAI,CACF,iBAAiB,EACf,eAAe,GACf,gBAAgB,GAChB,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,WAAW,GACX,kBAAkB,GAClB,cAAc,CACjB,CACF,CAYA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAe5F"}

package/dist/default-config.js

@@ -0,0 +1,32 @@
+import { DEFAULT_DOC_FILES, DEFAULT_KNOWLEDGE_FILES, DEFAULT_PATH_FILES, DEFAULT_PIPELINE_FILES, DEFAULT_RULE_FILES, DEFAULT_SHARKCRAFT_DIR, DEFAULT_TEMPLATE_FILES, } from "./sharkcraft-config.js";
+export const DEFAULT_MAX_TOKENS = 4000;
+export function getDefaultConfig() {
+    return {
+        sharkcraftDir: DEFAULT_SHARKCRAFT_DIR,
+        knowledgeFiles: [...DEFAULT_KNOWLEDGE_FILES],
+        ruleFiles: [...DEFAULT_RULE_FILES],
+        pathFiles: [...DEFAULT_PATH_FILES],
+        templateFiles: [...DEFAULT_TEMPLATE_FILES],
+        pipelineFiles: [...DEFAULT_PIPELINE_FILES],
+        docsFiles: [...DEFAULT_DOC_FILES],
+        defaultMaxTokens: DEFAULT_MAX_TOKENS,
+        defaultScope: [],
+    };
+}
+export function withDefaults(config) {
+    const defaults = getDefaultConfig();
+    if (!config)
+        return defaults;
+    return {
+        ...defaults,
+        ...config,
+        knowledgeFiles: config.knowledgeFiles ?? defaults.knowledgeFiles,
+        ruleFiles: config.ruleFiles ?? defaults.ruleFiles,
+        pathFiles: config.pathFiles ?? defaults.pathFiles,
+        templateFiles: config.templateFiles ?? defaults.templateFiles,
+        pipelineFiles: config.pipelineFiles ?? defaults.pipelineFiles,
+        docsFiles: config.docsFiles ?? defaults.docsFiles,
+        defaultMaxTokens: config.defaultMaxTokens ?? defaults.defaultMaxTokens,
+        defaultScope: config.defaultScope ?? defaults.defaultScope,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './sharkcraft-config.js';
+export * from './default-config.js';
+export * from './config-loader.js';
+export * from './config-validator.js';
+export * from './project-config-resolver.js';
+export * from './config-schema.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,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./sharkcraft-config.js";
+export * from "./default-config.js";
+export * from "./config-loader.js";
+export * from "./config-validator.js";
+export * from "./project-config-resolver.js";
+export * from "./config-schema.js";

package/dist/project-config-resolver.d.ts

@@ -0,0 +1,7 @@
+export interface ProjectRootInfo {
+    root: string;
+    markers: string[];
+}
+export declare function detectProjectRoot(startDir: string): ProjectRootInfo;
+export declare function findSharkcraftDir(projectRoot: string, configuredDir?: string): string | null;
+//# sourceMappingURL=project-config-resolver.d.ts.map

package/dist/project-config-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config-resolver.d.ts","sourceRoot":"","sources":["../src/project-config-resolver.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAYnE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,SAAe,GAAG,MAAM,GAAG,IAAI,CAUlG"}

package/dist/project-config-resolver.js

@@ -0,0 +1,37 @@
+import { existsSync, statSync } from 'node:fs';
+import * as nodePath from 'node:path';
+const PROJECT_ROOT_MARKERS = [
+    'package.json',
+    'bun.lockb',
+    'pnpm-workspace.yaml',
+    'nx.json',
+    'tsconfig.base.json',
+    '.git',
+];
+export function detectProjectRoot(startDir) {
+    let current = nodePath.resolve(startDir);
+    const seen = [];
+    while (true) {
+        const found = PROJECT_ROOT_MARKERS.filter((m) => existsSync(nodePath.join(current, m)));
+        if (found.length > 0)
+            return { root: current, markers: found };
+        const parent = nodePath.dirname(current);
+        if (parent === current) {
+            return { root: nodePath.resolve(startDir), markers: seen };
+        }
+        current = parent;
+    }
+}
+export function findSharkcraftDir(projectRoot, configuredDir = 'sharkcraft') {
+    const candidate = nodePath.join(projectRoot, configuredDir);
+    if (existsSync(candidate)) {
+        try {
+            if (statSync(candidate).isDirectory())
+                return candidate;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}

package/dist/sharkcraft-config.d.ts

@@ -0,0 +1,102 @@
+export interface ISharkCraftConfig {
+    /** Optional project identifier used in outputs / context. */
+    projectName?: string;
+    /** Human-readable one-line project description. */
+    description?: string;
+    /** Folder (relative to project root) containing SharkCraft project data. */
+    sharkcraftDir?: string;
+    /** Knowledge entry files (TS or markdown). Relative to sharkcraftDir. */
+    knowledgeFiles?: string[];
+    /** Markdown doc files (optional human depth). Relative to sharkcraftDir. */
+    docsFiles?: string[];
+    /** Rule registry files. */
+    ruleFiles?: string[];
+    /** Path-convention registry files. */
+    pathFiles?: string[];
+    /** Template registry files. */
+    templateFiles?: string[];
+    /** Pipeline registry files. */
+    pipelineFiles?: string[];
+    /** Default token budget for context retrieval. */
+    defaultMaxTokens?: number;
+    /** Default frameworks/scopes this project belongs to. */
+    defaultScope?: string[];
+    /** Toggle action-hint quality diagnostics in doctor. Default true. */
+    actionHintDiagnostics?: boolean;
+    /** Free-form metadata. */
+    metadata?: Record<string, unknown>;
+    /**
+     * Verification commands available to `shrk apply --validate --verification <id>`.
+     * Only commands defined here (with `trusted: true`) run by default. Pack-
+     * contributed commands are intentionally **not** auto-run in v1 — pass
+     * `--allow-pack-commands` to opt in to a future feature.
+     */
+    verificationCommands?: readonly IVerificationCommand[];
+    /**
+     * Local preset/boundary/context-test/agent-test files. Populated by the
+     * inspector but typed here for completeness.
+     */
+    presetFiles?: readonly string[];
+    boundaryFiles?: readonly string[];
+    contextTestFiles?: readonly string[];
+    agentTestFiles?: readonly string[];
+    /**
+     * Adaptive surface gating.
+     *
+     *   - `enabled`: experimental commands the project opts into.
+     *     Pack-contributed commands and entries marked `hidden: true` in
+     *     the catalog default to tier=`experimental`; they're listed by
+     *     `shrk surface list` but invisible in `--help` and refuse on
+     *     invocation until added here.
+     *   - `hidden`: extended commands the project chooses to hide from
+     *     `--help`. They remain callable. Used by shape-aware init to
+     *     hide monorepo-only commands in a single-app repo.
+     *
+     * Core commands cannot appear in either list — the resolver flags
+     * such configs in `shrk surface list --json` and `shrk doctor`.
+     */
+    surface?: ISurfaceConfig;
+    /**
+     * Local usage log opt-out.
+     *
+     * Defaults to `{ enabled: true }`. When disabled, no entries are
+     * written to `.sharkcraft/usage/commands.jsonl`. The env var
+     * `SHARKCRAFT_USAGE_DISABLED=1` also disables the writer
+     * regardless of this field.
+     */
+    usage?: IUsageConfig;
+}
+export interface ISurfaceConfig {
+    /**
+     * Named profile (e.g. `small-app`, `monorepo`,
+     * `pack-author`, `ci`, `agent`). Built-in profiles ship from the
+     * engine; packs may contribute additional profiles via the pack
+     * manifest. When set, the profile's `hidden[]` + `enabled[]`
+     * merge with the explicit arrays below (config wins on conflicts).
+     */
+    profile?: string;
+    enabled?: readonly string[];
+    hidden?: readonly string[];
+}
+export interface IUsageConfig {
+    enabled?: boolean;
+}
+export interface IVerificationCommand {
+    /** Stable id used by `--verification <id>`. */
+    id: string;
+    /** Human-readable label. */
+    label?: string;
+    /** Shell command to execute. */
+    command: string;
+    /** `true` opts the command into the default run set. */
+    trusted?: boolean;
+}
+export declare const DEFAULT_SHARKCRAFT_DIR = "sharkcraft";
+export declare const DEFAULT_KNOWLEDGE_FILES: string[];
+export declare const DEFAULT_RULE_FILES: string[];
+export declare const DEFAULT_PATH_FILES: string[];
+export declare const DEFAULT_TEMPLATE_FILES: string[];
+export declare const DEFAULT_PIPELINE_FILES: string[];
+export declare const DEFAULT_DOC_FILES: string[];
+export declare function defineSharkCraftConfig(config: ISharkCraftConfig): ISharkCraftConfig;
+//# sourceMappingURL=sharkcraft-config.d.ts.map

package/dist/sharkcraft-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharkcraft-config.d.ts","sourceRoot":"","sources":["../src/sharkcraft-config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAEvD;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,eAAO,MAAM,uBAAuB,UAAyC,CAAC;AAC9E,eAAO,MAAM,kBAAkB,UAAqC,CAAC;AACrE,eAAO,MAAM,kBAAkB,UAAqC,CAAC;AACrE,eAAO,MAAM,sBAAsB,UAA6C,CAAC;AACjF,eAAO,MAAM,sBAAsB,UAA6C,CAAC;AACjF,eAAO,MAAM,iBAAiB,UAI7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,CAEnF"}

package/dist/sharkcraft-config.js

@@ -0,0 +1,14 @@
+export const DEFAULT_SHARKCRAFT_DIR = 'sharkcraft';
+export const DEFAULT_KNOWLEDGE_FILES = ['knowledge.ts', 'knowledge/index.ts'];
+export const DEFAULT_RULE_FILES = ['rules.ts', 'knowledge/rules.ts'];
+export const DEFAULT_PATH_FILES = ['paths.ts', 'knowledge/paths.ts'];
+export const DEFAULT_TEMPLATE_FILES = ['templates.ts', 'knowledge/templates.ts'];
+export const DEFAULT_PIPELINE_FILES = ['pipelines.ts', 'knowledge/pipelines.ts'];
+export const DEFAULT_DOC_FILES = [
+    'docs/overview.md',
+    'docs/architecture.md',
+    'docs/quick-start.md',
+];
+export function defineSharkCraftConfig(config) {
+    return config;
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@shrkcrft/config",
+  "version": "0.1.0-alpha.1",
+  "description": "SharkCraft config loader: sharkcraft.config.ts discovery, defaults, zod-validated schema.",
+  "license": "MIT",
+  "author": "SharkCraft contributors",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sharkcraft/sharkcraft.git",
+    "directory": "packages/config"
+  },
+  "homepage": "https://github.com/sharkcraft/sharkcraft",
+  "bugs": {
+    "url": "https://github.com/sharkcraft/sharkcraft/issues"
+  },
+  "keywords": [
+    "sharkcraft",
+    "config",
+    "loader",
+    "zod"
+  ],
+  "engines": {
+    "bun": ">=1.1.0",
+    "node": ">=18"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@shrkcrft/core": "^0.1.0-alpha.1",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}