@shrkcrft/cli 0.1.0-alpha.2

package/dist/commands/diagnostics.command.d.ts

@@ -0,0 +1,5 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const diagnosticsListCommand: ICommandHandler;
+export declare const diagnosticsGetCommand: ICommandHandler;
+export declare const diagnosticsSuggestCommand: ICommandHandler;
+//# sourceMappingURL=diagnostics.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.command.d.ts","sourceRoot":"","sources":["../../src/commands/diagnostics.command.ts"],"names":[],"mappings":"AAQA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,sBAAsB,EAAE,eAiBpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,eA+BnC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eAsCvC,CAAC"}

package/dist/commands/diagnostics.command.js

@@ -0,0 +1,97 @@
+import { readFileSync } from 'node:fs';
+import { buildDiagnosticByCode, getDiagnosticEntry, listDiagnostics, renderDiagnosticText, suggestDiagnostic, } from '@shrkcrft/inspector';
+import { flagBool, flagString, flagList, } from "../command-registry.js";
+import { asJson, header } from "../output/format-output.js";
+export const diagnosticsListCommand = {
+    name: 'list',
+    description: 'List known SharkCraft failure diagnostics. Read-only.',
+    usage: 'shrk diagnostics list [--json]',
+    async run(args) {
+        const entries = listDiagnostics();
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson({ schema: 'sharkcraft.diagnostic-registry/v1', entries }) + '\n');
+            return 0;
+        }
+        process.stdout.write(header(`Diagnostics (${entries.length})`));
+        for (const e of entries) {
+            const keys = e.contextKeys.length === 0 ? '' : ` context: ${e.contextKeys.join(', ')}`;
+            process.stdout.write(`  ${e.code.padEnd(34)} ${e.description}${keys}\n`);
+        }
+        return 0;
+    },
+};
+export const diagnosticsGetCommand = {
+    name: 'get',
+    description: 'Look up a SharkCraft failure diagnostic by code. Read-only.',
+    usage: 'shrk diagnostics get <code> [--ctx key=value ...] [--json]',
+    async run(args) {
+        const code = args.positional[0];
+        if (!code) {
+            process.stderr.write('Usage: shrk diagnostics get <code> [--ctx key=value ...]\n');
+            return 2;
+        }
+        const entry = getDiagnosticEntry(code);
+        if (!entry) {
+            process.stderr.write(`Unknown diagnostic code "${code}". Try \`shrk diagnostics list\`.\n`);
+            return 2;
+        }
+        const ctx = {};
+        for (const raw of flagList(args, 'ctx')) {
+            const i = raw.indexOf('=');
+            if (i < 0)
+                continue;
+            const key = raw.slice(0, i).trim();
+            const value = raw.slice(i + 1);
+            ctx[key] = value;
+        }
+        const diagnostic = buildDiagnosticByCode(entry.code, ctx);
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(diagnostic) + '\n');
+            return 0;
+        }
+        process.stdout.write(renderDiagnosticText(diagnostic));
+        return 0;
+    },
+};
+export const diagnosticsSuggestCommand = {
+    name: 'suggest',
+    description: 'Suggest the most likely diagnostic for a stderr blob. Read-only.',
+    usage: 'shrk diagnostics suggest "<error text>" | --from-file <file> [--json]',
+    async run(args) {
+        const fromFile = flagString(args, 'from-file');
+        let input = args.positional.join(' ').trim();
+        if (fromFile) {
+            try {
+                input = readFileSync(fromFile, 'utf8');
+            }
+            catch (err) {
+                process.stderr.write(`Failed to read --from-file: ${err instanceof Error ? err.message : String(err)}\n`);
+                return 1;
+            }
+        }
+        if (!input) {
+            process.stderr.write('Usage: shrk diagnostics suggest "<error text>" or --from-file <file>\n');
+            return 2;
+        }
+        const r = suggestDiagnostic(input);
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(r) + '\n');
+            return 0;
+        }
+        if (!r.topSuggestion) {
+            process.stdout.write('No matching diagnostic found.\n');
+            return 1;
+        }
+        process.stdout.write(`Top suggestion: ${r.topSuggestion.code} (${r.topSuggestion.confidence})\n`);
+        process.stdout.write(`  title: ${r.topSuggestion.title}\n`);
+        process.stdout.write(`  next:  ${r.topSuggestion.nextCommand}\n`);
+        if (r.topSuggestion.docsLink)
+            process.stdout.write(`  docs:  ${r.topSuggestion.docsLink}\n`);
+        if (r.candidates.length > 1) {
+            process.stdout.write('Other candidates:\n');
+            for (const c of r.candidates.slice(1))
+                process.stdout.write(`  ${c.code} (${c.confidence})\n`);
+        }
+        return 0;
+    },
+};

package/dist/commands/docs.command.d.ts

@@ -0,0 +1,4 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const docsCheckCommand: ICommandHandler;
+export declare const examplesCheckCommand: ICommandHandler;
+//# sourceMappingURL=docs.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.command.d.ts","sourceRoot":"","sources":["../../src/commands/docs.command.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAGhC,eAAO,MAAM,gBAAgB,EAAE,eAc9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eAelC,CAAC"}

package/dist/commands/docs.command.js

@@ -0,0 +1,34 @@
+import { buildDocsCheck, renderDocsCheckText } from '@shrkcrft/inspector';
+import { flagBool, resolveCwd, } from "../command-registry.js";
+import { asJson } from "../output/format-output.js";
+export const docsCheckCommand = {
+    name: 'check',
+    description: 'Verify docs/ and README content (read-only).',
+    usage: 'shrk docs check [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const report = buildDocsCheck(cwd);
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(report) + '\n');
+            return report.ok ? 0 : 1;
+        }
+        process.stdout.write(renderDocsCheckText(report));
+        return report.ok ? 0 : 1;
+    },
+};
+export const examplesCheckCommand = {
+    name: 'check',
+    description: 'Verify examples/ tree integrity (read-only).',
+    usage: 'shrk examples check [--json]',
+    async run(args) {
+        const cwd = resolveCwd(args);
+        const { buildExamplesCheck, renderExamplesCheckText } = await import('@shrkcrft/inspector');
+        const report = buildExamplesCheck(cwd);
+        if (flagBool(args, 'json')) {
+            process.stdout.write(asJson(report) + '\n');
+            return report.ok ? 0 : 1;
+        }
+        process.stdout.write(renderExamplesCheckText(report));
+        return report.ok ? 0 : 1;
+    },
+};

package/dist/commands/doctor.command.d.ts

@@ -0,0 +1,7 @@
+import { type ICommandHandler } from '../command-registry.js';
+export declare const doctorCommand: ICommandHandler;
+export declare const doctorSuppressCommand: ICommandHandler;
+export declare const doctorSuppressionsCommand: ICommandHandler;
+export declare const doctorAcknowledgeCommand: ICommandHandler;
+export declare const doctorAcknowledgementsCommand: ICommandHandler;
+//# sourceMappingURL=doctor.command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.command.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.command.ts"],"names":[],"mappings":"AAqBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAwJhC,eAAO,MAAM,aAAa,EAAE,eAW3B,CAAC;AA0ZF,eAAO,MAAM,qBAAqB,EAAE,eAmCnC,CAAC;AAuDF,eAAO,MAAM,yBAAyB,EAAE,eAavC,CAAC;AAIF,eAAO,MAAM,wBAAwB,EAAE,eA2CtC,CAAC;AAgCF,eAAO,MAAM,6BAA6B,EAAE,eAa3C,CAAC"}