@shrkcrft/inspector 0.1.0-alpha.2

package/dist/ownership.d.ts

@@ -0,0 +1,38 @@
+export declare const OWNERSHIP_SCHEMA = "sharkcraft.ownership-rule/v1";
+export interface IOwnershipRule {
+    id: string;
+    title: string;
+    paths: readonly string[];
+    owners: readonly string[];
+    reviewers: readonly string[];
+    tags: readonly string[];
+    notes?: string;
+    severity?: 'info' | 'warning' | 'error';
+    requiredReview?: boolean;
+}
+export interface IOwnershipMatch {
+    file: string;
+    rules: readonly IOwnershipRule[];
+    owners: readonly string[];
+    reviewers: readonly string[];
+    requiredReview: boolean;
+}
+export interface IOwnershipImpact {
+    files: readonly string[];
+    matches: readonly IOwnershipMatch[];
+    /** Distinct owners across all matches. */
+    owners: readonly string[];
+    /** Distinct reviewers across all matches. */
+    reviewers: readonly string[];
+    /** Files needing required review. */
+    requiredReviewFiles: readonly string[];
+}
+export interface ILoadOwnershipResult {
+    rules: readonly IOwnershipRule[];
+    sources: readonly string[];
+    warnings: readonly string[];
+}
+export declare function loadOwnershipRules(cwd: string, configured?: readonly string[]): Promise<ILoadOwnershipResult>;
+export declare function matchFile(file: string, rules: readonly IOwnershipRule[]): IOwnershipMatch;
+export declare function impactFor(files: readonly string[], rules: readonly IOwnershipRule[]): IOwnershipImpact;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB,iCAAiC,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,0CAA0C;IAC1C,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,qCAAqC;IACrC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IACjC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAID,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA2B/B;AA6CD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,eAAe,CAQzF;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,gBAAgB,CAMlB"}

package/dist/ownership.js

@@ -0,0 +1,102 @@
+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, readFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { pathToFileURL } from 'node:url';
+export const OWNERSHIP_SCHEMA = 'sharkcraft.ownership-rule/v1';
+const DEFAULT_PATHS = ['sharkcraft/ownership.ts', 'CODEOWNERS', '.github/CODEOWNERS'];
+export async function loadOwnershipRules(cwd, configured) {
+    const rules = [];
+    const sources = [];
+    const warnings = [];
+    const candidates = configured && configured.length > 0 ? configured : DEFAULT_PATHS;
+    for (const rel of candidates) {
+        const full = nodePath.resolve(cwd, rel);
+        if (!existsSync(full))
+            continue;
+        sources.push(full);
+        if (full.endsWith('.ts') || full.endsWith('.js') || full.endsWith('.mjs') || full.endsWith('.cjs')) {
+            try {
+                // pathToFileURL mirrors the resolver pattern in TypeScriptKnowledgeLoader.
+                const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(full).href)));
+                const list = mod.default ?? mod.ownershipRules ?? [];
+                for (const r of list)
+                    rules.push(normalize(r));
+            }
+            catch (e) {
+                warnings.push(`ownership: failed to load ${full}: ${e.message}`);
+            }
+        }
+        else {
+            const text = readFileSync(full, 'utf8');
+            rules.push(...parseCodeOwners(text, full));
+        }
+    }
+    return { rules, sources, warnings };
+}
+function normalize(r) {
+    return {
+        ...r,
+        paths: r.paths ?? [],
+        owners: r.owners ?? [],
+        reviewers: r.reviewers ?? [],
+        tags: r.tags ?? [],
+    };
+}
+function parseCodeOwners(text, file) {
+    const out = [];
+    const lines = text.split('\n');
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i].replace(/#.*$/, '').trim();
+        if (!line)
+            continue;
+        const parts = line.split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const pattern = parts[0];
+        const owners = parts.slice(1);
+        out.push({
+            id: `codeowners:${i + 1}`,
+            title: `CODEOWNERS line ${i + 1}: ${pattern}`,
+            paths: [globToPrefix(pattern)],
+            owners,
+            reviewers: owners,
+            tags: ['codeowners'],
+            notes: `from ${nodePath.basename(file)}`,
+        });
+    }
+    return out;
+}
+function globToPrefix(g) {
+    // Strip leading "/" and trailing "/*" / "/**".
+    let s = g.startsWith('/') ? g.slice(1) : g;
+    s = s.replace(/\/\*\*?$/, '');
+    // Truncate at the first wildcard so we still get a path prefix.
+    const idx = s.search(/[*?\[]/);
+    if (idx >= 0)
+        s = s.slice(0, idx);
+    return s.replace(/\/$/, '');
+}
+export function matchFile(file, rules) {
+    const matched = rules.filter((r) => r.paths.some((p) => file === p || file.startsWith(p + '/') || file.includes(p)));
+    const owners = uniqueStrings(matched.flatMap((r) => r.owners));
+    const reviewers = uniqueStrings(matched.flatMap((r) => r.reviewers));
+    const requiredReview = matched.some((r) => r.requiredReview === true);
+    return { file, rules: matched, owners, reviewers, requiredReview };
+}
+export function impactFor(files, rules) {
+    const matches = files.map((f) => matchFile(f, rules));
+    const owners = uniqueStrings(matches.flatMap((m) => m.owners));
+    const reviewers = uniqueStrings(matches.flatMap((m) => m.reviewers));
+    const requiredReviewFiles = matches.filter((m) => m.requiredReview).map((m) => m.file);
+    return { files, matches, owners, reviewers, requiredReviewFiles };
+}
+function uniqueStrings(xs) {
+    return [...new Set(xs)].sort();
+}

package/dist/pack-author-ux.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pack-author developer UX.
+ *
+ *  - buildPackDevStatus({ packPath, consumerPath }) — what the consumer sees:
+ *    source vs node_modules vs symlink, signed-manifest staleness, contribution
+ *    counts.
+ *  - planPackWatchCommand({ packPath, command }) — pure helper that returns
+ *    the resolved watch command and the file globs to observe (no spawning
+ *    happens here — the CLI command spawns the child).
+ */
+export interface IPackDevStatus {
+    schema: 'sharkcraft.pack-dev-status/v1';
+    packPath: string;
+    consumerPath?: string | undefined;
+    packExists: boolean;
+    manifestPath: string | null;
+    signedManifestPath: string | null;
+    packVersion: string | null;
+    consumerSeesPackFrom: 'source' | 'node_modules' | 'symlink' | 'not-installed' | 'self';
+    signatureStaleness: 'fresh' | 'stale' | 'missing' | 'unknown';
+    staleAssets: ReadonlyArray<string>;
+    contributionCounts: Readonly<{
+        rules: number;
+        paths: number;
+        templates: number;
+        pipelines: number;
+        presets: number;
+        boundaries: number;
+        knowledge: number;
+        playbooks: number;
+        constructs: number;
+        docsFiles: number;
+    }>;
+    warnings: ReadonlyArray<string>;
+    nextCommandHint: string;
+}
+export declare function buildPackDevStatus(input: {
+    packPath: string;
+    consumerPath?: string;
+}): IPackDevStatus;
+export interface IPackWatchPlan {
+    schema: 'sharkcraft.pack-watch-plan/v1';
+    packPath: string;
+    consumerPath?: string;
+    command: string;
+    args: ReadonlyArray<string>;
+    globs: ReadonlyArray<string>;
+    debounceMs: number;
+    willSign: false;
+}
+export declare function planPackWatchCommand(input: {
+    packPath: string;
+    consumerPath?: string;
+    command?: string;
+    debounceMs?: number;
+}): IPackWatchPlan;
+export declare function renderPackDevStatusText(status: IPackDevStatus): string;
+//# sourceMappingURL=pack-author-ux.d.ts.map

package/dist/pack-author-ux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-author-ux.d.ts","sourceRoot":"","sources":["../src/pack-author-ux.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,+BAA+B,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oBAAoB,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,eAAe,GAAG,MAAM,CAAC;IACvF,kBAAkB,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC9D,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,kBAAkB,EAAE,QAAQ,CAAC;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;CACzB;AA4ED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,cAAc,CAwFjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,+BAA+B,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,cAAc,CAYjB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyBtE"}

package/dist/pack-author-ux.js

@@ -0,0 +1,219 @@
+/**
+ * Pack-author developer UX.
+ *
+ *  - buildPackDevStatus({ packPath, consumerPath }) — what the consumer sees:
+ *    source vs node_modules vs symlink, signed-manifest staleness, contribution
+ *    counts.
+ *  - planPackWatchCommand({ packPath, command }) — pure helper that returns
+ *    the resolved watch command and the file globs to observe (no spawning
+ *    happens here — the CLI command spawns the child).
+ */
+import { existsSync, lstatSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+const WATCHED_GLOBS = Object.freeze([
+    'src/assets/**/*.ts',
+    'package.json',
+    'manifest.json',
+    'sharkcraft.plugin.signed.json',
+    'README.md',
+    'SECURITY.md',
+]);
+function readJsonSafe(p) {
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function countTsExports(absFile) {
+    if (!existsSync(absFile))
+        return 0;
+    const txt = readFileSync(absFile, 'utf8');
+    // Count default array entries: lines like `  pluginContract,` at brace depth 1.
+    const m = txt.match(/^export default \[([\s\S]*?)\];/m);
+    if (m && m[1]) {
+        return m[1].split(',').filter((s) => s.trim().length > 0).length;
+    }
+    // Fallback: count named exports.
+    const named = txt.match(/^export const /gm);
+    return named ? named.length : 0;
+}
+function walkSourceAssetMtimes(packPath) {
+    const root = join(packPath, 'src', 'assets');
+    let newestMtimeMs = 0;
+    const out = [];
+    if (!existsSync(root))
+        return { newestMtimeMs, files: out };
+    const walk = (dir) => {
+        for (const e of readdirSync(dir, { withFileTypes: true })) {
+            const p = join(dir, e.name);
+            if (e.isDirectory())
+                walk(p);
+            else if (e.isFile() && e.name.endsWith('.ts')) {
+                const st = statSync(p);
+                out.push(p);
+                if (st.mtimeMs > newestMtimeMs)
+                    newestMtimeMs = st.mtimeMs;
+            }
+        }
+    };
+    walk(root);
+    return { newestMtimeMs, files: out };
+}
+function detectConsumerSource(packPath, consumerPath) {
+    // Read consumer package.json to find pack name.
+    const pkgPath = join(packPath, 'package.json');
+    if (!existsSync(pkgPath))
+        return 'not-installed';
+    const pkg = readJsonSafe(pkgPath);
+    if (!pkg?.name)
+        return 'not-installed';
+    const consumerNm = join(consumerPath, 'node_modules', pkg.name);
+    if (existsSync(consumerNm)) {
+        try {
+            const lstat = lstatSync(consumerNm);
+            if (lstat.isSymbolicLink())
+                return 'symlink';
+        }
+        catch {
+            /* fall through */
+        }
+        return 'node_modules';
+    }
+    // Same path → consumer is the pack itself.
+    if (resolve(packPath) === resolve(consumerPath))
+        return 'self';
+    return 'source';
+}
+export function buildPackDevStatus(input) {
+    const { packPath } = input;
+    const warnings = [];
+    if (!existsSync(packPath)) {
+        return {
+            schema: 'sharkcraft.pack-dev-status/v1',
+            packPath,
+            packExists: false,
+            manifestPath: null,
+            signedManifestPath: null,
+            packVersion: null,
+            consumerSeesPackFrom: 'not-installed',
+            signatureStaleness: 'unknown',
+            staleAssets: [],
+            contributionCounts: {
+                rules: 0,
+                paths: 0,
+                templates: 0,
+                pipelines: 0,
+                presets: 0,
+                boundaries: 0,
+                knowledge: 0,
+                playbooks: 0,
+                constructs: 0,
+                docsFiles: 0,
+            },
+            warnings: [`Pack path does not exist: ${packPath}`],
+            nextCommandHint: 'shrk packs new <name>',
+        };
+    }
+    const manifestPath = join(packPath, 'manifest.json');
+    const signedManifestPath = join(packPath, 'sharkcraft.plugin.signed.json');
+    const pkg = readJsonSafe(join(packPath, 'package.json'));
+    const contributionCounts = {
+        rules: countTsExports(join(packPath, 'src/assets/rules.ts')),
+        paths: countTsExports(join(packPath, 'src/assets/paths.ts')),
+        templates: countTsExports(join(packPath, 'src/assets/templates.ts')),
+        pipelines: countTsExports(join(packPath, 'src/assets/pipelines.ts')),
+        presets: countTsExports(join(packPath, 'src/assets/presets.ts')),
+        boundaries: countTsExports(join(packPath, 'src/assets/boundaries.ts')),
+        knowledge: countTsExports(join(packPath, 'src/assets/knowledge.ts')),
+        playbooks: countTsExports(join(packPath, 'src/assets/playbooks.ts')),
+        constructs: countTsExports(join(packPath, 'src/assets/constructs.ts')),
+        docsFiles: 0,
+    };
+    let signatureStaleness = 'unknown';
+    const staleAssets = [];
+    if (existsSync(signedManifestPath)) {
+        const sigMtime = statSync(signedManifestPath).mtimeMs;
+        const { newestMtimeMs, files } = walkSourceAssetMtimes(packPath);
+        if (newestMtimeMs > sigMtime + 500) {
+            signatureStaleness = 'stale';
+            for (const f of files) {
+                const st = statSync(f).mtimeMs;
+                if (st > sigMtime + 500)
+                    staleAssets.push(relative(packPath, f));
+            }
+            warnings.push(`Signed manifest is older than ${staleAssets.length} asset file(s). Re-sign with \`shrk packs sign\`.`);
+        }
+        else {
+            signatureStaleness = 'fresh';
+        }
+    }
+    else {
+        signatureStaleness = 'missing';
+        warnings.push('No signed manifest found. Run `shrk packs sign` before publishing.');
+    }
+    const consumerPath = input.consumerPath ? resolve(input.consumerPath) : undefined;
+    const consumerSeesPackFrom = consumerPath
+        ? detectConsumerSource(packPath, consumerPath)
+        : 'not-installed';
+    return {
+        schema: 'sharkcraft.pack-dev-status/v1',
+        packPath,
+        consumerPath: consumerPath ?? undefined,
+        packExists: true,
+        manifestPath: existsSync(manifestPath) ? manifestPath : null,
+        signedManifestPath: existsSync(signedManifestPath) ? signedManifestPath : null,
+        packVersion: pkg?.version ?? null,
+        consumerSeesPackFrom,
+        signatureStaleness,
+        staleAssets,
+        contributionCounts,
+        warnings,
+        nextCommandHint: signatureStaleness === 'stale'
+            ? `shrk packs sign --pack ${packPath.split(sep).pop()}`
+            : `shrk packs doctor --release --cwd ${packPath}`,
+    };
+}
+export function planPackWatchCommand(input) {
+    const command = input.command ?? 'shrk packs doctor --release && shrk commands doctor';
+    return {
+        schema: 'sharkcraft.pack-watch-plan/v1',
+        packPath: input.packPath,
+        ...(input.consumerPath ? { consumerPath: input.consumerPath } : {}),
+        command,
+        args: [],
+        globs: [...WATCHED_GLOBS],
+        debounceMs: input.debounceMs ?? 300,
+        willSign: false,
+    };
+}
+export function renderPackDevStatusText(status) {
+    const lines = [];
+    lines.push(`=== Pack dev-status ===`);
+    lines.push(`  pack            ${status.packPath}`);
+    if (status.consumerPath)
+        lines.push(`  consumer        ${status.consumerPath}`);
+    lines.push(`  version         ${status.packVersion ?? '(unknown)'}`);
+    lines.push(`  seen as         ${status.consumerSeesPackFrom}`);
+    lines.push(`  signature       ${status.signatureStaleness}`);
+    if (status.staleAssets.length > 0) {
+        lines.push(`  stale assets    ${status.staleAssets.length}`);
+        for (const a of status.staleAssets.slice(0, 8))
+            lines.push(`                  • ${a}`);
+    }
+    lines.push('');
+    lines.push('Contributions:');
+    for (const [k, v] of Object.entries(status.contributionCounts)) {
+        lines.push(`  ${k.padEnd(12)} ${v}`);
+    }
+    if (status.warnings.length > 0) {
+        lines.push('');
+        lines.push('Warnings:');
+        for (const w of status.warnings)
+            lines.push(`  ⚠ ${w}`);
+    }
+    lines.push('');
+    lines.push(`Next: ${status.nextCommandHint}`);
+    return lines.join('\n') + '\n';
+}

package/dist/pack-author.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Pack asset authoring workflow.
+ *
+ * Generic, preview-first orchestrator over the asset kinds a SharkCraft
+ * pack can ship:
+ *   - status (read-only inventory of asset kinds + per-kind counts + signature)
+ *   - preview (delegate to knowledge for the load-bearing kind; other
+ *     kinds return an explicit "not yet implemented" preview with a clear
+ *     next-step list)
+ *   - pending (cross-section: modified files, drafts under .sharkcraft/,
+ *     stale signature, missing-secret state) — composed in `pack-pending.ts`.
+ *
+ * Hard rules:
+ *   - Never mutate pack source. Drafts go under .sharkcraft/authoring/.
+ *   - Honest: refuse to fake an authoring slice we don't yet support.
+ *   - No project-specific logic.
+ */
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const PACK_AUTHOR_STATUS_SCHEMA = "sharkcraft.pack-author-status/v1";
+export declare const PACK_AUTHOR_PREVIEW_SCHEMA = "sharkcraft.pack-author-preview/v1";
+export declare const PACK_AUTHOR_VALIDATE_SCHEMA = "sharkcraft.pack-author-validate/v1";
+export declare enum PackAuthorKind {
+    Knowledge = "knowledge",
+    SearchTuning = "search-tuning",
+    FeedbackRule = "feedback-rule",
+    AgentTest = "agent-test",
+    Convention = "convention",
+    TaskRoutingHint = "task-routing-hint",
+    RegistrationHint = "registration-hint",
+    ScaffoldPattern = "scaffold-pattern"
+}
+export interface IPackAuthorTargetEntry {
+    /** 'local' = sharkcraft/<kind>.ts, 'pack' = a pack assets/<kind>.ts. */
+    kind: 'local' | 'pack';
+    packName?: string;
+    packageRoot?: string;
+    /** Project-relative path the human/agent would edit. */
+    filePath?: string;
+    /** Whether the resolver found the file. */
+    exists: boolean;
+}
+export interface IPackAuthorStatus {
+    schema: typeof PACK_AUTHOR_STATUS_SCHEMA;
+    generatedAt: string;
+    projectRoot: string;
+    /** Map of kind → number of contributions across local + packs. */
+    contributionCounts: Readonly<Record<string, number>>;
+    /** Number of pending draft files under .sharkcraft/authoring/. */
+    pendingDrafts: number;
+    pendingDraftFiles: readonly string[];
+    /** Whether the asset-provenance ledger exists. */
+    provenanceExists: boolean;
+    /** Whether SHARKCRAFT_PACK_SECRET is available in env. */
+    secretAvailable: boolean;
+    /** Per-kind, where the local + pack files live. */
+    resolvedTargets: Readonly<Record<string, IPackAuthorTargetEntry[]>>;
+    /** Honest about which kinds are implemented vs deferred. */
+    authoringSupport: Readonly<Record<string, 'preview' | 'deferred'>>;
+    /** Recommended next commands. */
+    nextCommands: readonly string[];
+}
+export declare function buildPackAuthorStatus(inspection: ISharkcraftInspection): IPackAuthorStatus;
+export interface IPackAuthorPreviewInput {
+    kind: PackAuthorKind;
+    /** Asset id (e.g. knowledge entry id). */
+    assetId: string;
+    /** Optional pack/local target. */
+    target?: IPackAuthorTargetEntry;
+    /** Provenance reason. */
+    reason?: string;
+}
+export interface IPackAuthorPreviewResult {
+    schema: typeof PACK_AUTHOR_PREVIEW_SCHEMA;
+    generatedAt: string;
+    kind: PackAuthorKind;
+    assetId: string;
+    /** True when the kind is implemented; false → deferred (returns next steps). */
+    implemented: boolean;
+    /** Honest message when implemented=false. */
+    deferralNote?: string;
+    /** Recommended next commands. */
+    nextCommands: readonly string[];
+}
+export declare function buildPackAuthorPreview(input: IPackAuthorPreviewInput): IPackAuthorPreviewResult;
+export interface IPackAuthorValidateResult {
+    schema: typeof PACK_AUTHOR_VALIDATE_SCHEMA;
+    generatedAt: string;
+    /** Whether the workspace currently looks healthy after authoring. */
+    ok: boolean;
+    /** Recommended commands to actually verify (this module does not run them). */
+    recommendedCommands: readonly string[];
+}
+export declare function buildPackAuthorValidatePlan(): IPackAuthorValidateResult;
+//# sourceMappingURL=pack-author.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack-author.d.ts","sourceRoot":"","sources":["../src/pack-author.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,yBAAyB,qCAAqC,CAAC;AAC5E,eAAO,MAAM,0BAA0B,sCAAsC,CAAC;AAC9E,eAAO,MAAM,2BAA2B,uCAAuC,CAAC;AAEhF,oBAAY,cAAc;IACxB,SAAS,cAAc;IACvB,YAAY,kBAAkB;IAC9B,YAAY,kBAAkB;IAC9B,SAAS,eAAe;IACxB,UAAU,eAAe;IACzB,eAAe,sBAAsB;IACrC,gBAAgB,sBAAsB;IACtC,eAAe,qBAAqB;CACrC;AAaD,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,yBAAyB,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,kDAAkD;IAClD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0DAA0D;IAC1D,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACpE,4DAA4D;IAC5D,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IACnE,iCAAiC;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,CAwGnB;AA0BD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,0BAA0B,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,uBAAuB,GAC7B,wBAAwB,CAiC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,OAAO,2BAA2B,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,EAAE,EAAE,OAAO,CAAC;IACZ,+EAA+E;IAC/E,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,2BAA2B,IAAI,yBAAyB,CAavE"}