@shrkcrft/cli 0.1.0-alpha.1

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"changes.command.d.ts","sourceRoot":"","sources":["../../src/commands/changes.command.ts"],"names":[],"mappings":"AAiBA,OAAO,EAKL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAqHhC,eAAO,MAAM,cAAc,EAAE,eAoB5B,CAAC"}

package/dist/commands/changes.command.js

@@ -0,0 +1,155 @@
+/**
+ * `shrk changes <verb>`.
+ *
+ * Generic changed-work summary. Reuses the existing `getChangedFiles`
+ * helper + `buildChangesSummary`.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import * as nodePath from 'node:path';
+import { buildAcceptanceReplay, buildChangesSummary, inspectSharkcraft, renderAcceptanceReplayMarkdown, renderAcceptanceReplayText, renderChangesSummaryMarkdown, ReplayProfile, } from '@shrkcrft/inspector';
+import { flagBool, flagString, flagList, resolveCwd, } from "../command-registry.js";
+import { asJson, header } from "../output/format-output.js";
+async function runChangesSummary(args) {
+    const cwd = resolveCwd(args);
+    const inspection = await inspectSharkcraft({ cwd });
+    const since = flagString(args, 'since');
+    const staged = flagBool(args, 'staged');
+    const files = flagList(args, 'files');
+    // Optional round / label propagated into the report.
+    const roundLabel = flagString(args, 'round') ?? flagString(args, 'label');
+    const opts = {};
+    if (since)
+        opts.since = since;
+    if (staged)
+        opts.staged = true;
+    if (files.length > 0)
+        opts.files = files;
+    if (roundLabel)
+        opts.roundLabel = roundLabel;
+    const report = await buildChangesSummary(inspection, opts);
+    const format = flagString(args, 'format') ?? (flagBool(args, 'json') ? 'json' : 'text');
+    const output = flagString(args, 'output');
+    if (format === 'json') {
+        const payload = asJson(report) + '\n';
+        if (output)
+            writeOutputFile(cwd, output, payload);
+        else
+            process.stdout.write(payload);
+        return 0;
+    }
+    if (format === 'markdown' || format === 'md') {
+        const md = renderChangesSummaryMarkdown(report);
+        if (output)
+            writeOutputFile(cwd, output, md);
+        else
+            process.stdout.write(md);
+        return 0;
+    }
+    // text
+    process.stdout.write(header(`Changes summary (${report.source}${report.ref ? ' ' + report.ref : ''}${report.roundLabel ? ` round=${report.roundLabel}` : ''})`));
+    process.stdout.write(`  total files: ${report.totalFiles}\n`);
+    process.stdout.write(`  risk:        ${report.risk}\n`);
+    for (const r of report.riskReasons)
+        process.stdout.write(`     · ${r}\n`);
+    process.stdout.write('\nFiles by area:\n');
+    for (const [area, list] of Object.entries(report.filesByArea)) {
+        process.stdout.write(`  ${area.padEnd(20)} (${list.length})\n`);
+    }
+    if (report.touchedMcpTools.length > 0) {
+        process.stdout.write('\nMCP tools touched (verify read-only invariant):\n');
+        for (const m of report.touchedMcpTools)
+            process.stdout.write(`  • ${m}\n`);
+    }
+    process.stdout.write('\nSuggested validation:\n');
+    for (const c of report.suggestedValidationCommands)
+        process.stdout.write(`  $ ${c}\n`);
+    process.stdout.write(`\nLikely PR summary: ${report.likelyPrSummary}\n`);
+    return 0;
+}
+function writeOutputFile(cwd, file, body) {
+    const abs = nodePath.isAbsolute(file) ? file : nodePath.join(cwd, file);
+    const dir = nodePath.dirname(abs);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(abs, body, 'utf8');
+    process.stdout.write(`Wrote ${abs}\n`);
+}
+async function runChangesAcceptanceReplay(args) {
+    const cwd = resolveCwd(args);
+    const inspection = await inspectSharkcraft({ cwd });
+    const since = flagString(args, 'since');
+    const staged = flagBool(args, 'staged');
+    const files = flagList(args, 'files');
+    const roundLabel = flagString(args, 'round') ?? flagString(args, 'label');
+    const profileRaw = flagString(args, 'profile') ?? 'changed-only';
+    const profile = (() => {
+        switch (profileRaw) {
+            case 'standard':
+                return ReplayProfile.Standard;
+            case 'strict':
+                return ReplayProfile.Strict;
+            case 'changed-only':
+            default:
+                return ReplayProfile.ChangedOnly;
+        }
+    })();
+    const summaryOpts = {};
+    if (since)
+        summaryOpts.since = since;
+    if (staged)
+        summaryOpts.staged = true;
+    if (files.length > 0)
+        summaryOpts.files = files;
+    if (roundLabel)
+        summaryOpts.roundLabel = roundLabel;
+    const summary = await buildChangesSummary(inspection, summaryOpts);
+    const replay = buildAcceptanceReplay({
+        summary,
+        profile,
+        ...(roundLabel ? { roundLabel } : {}),
+    });
+    const format = flagString(args, 'format') ?? (flagBool(args, 'json') ? 'json' : 'text');
+    const output = flagString(args, 'output');
+    if (format === 'json') {
+        const payload = asJson(replay) + '\n';
+        if (output)
+            writeOutputFile(cwd, output, payload);
+        else
+            process.stdout.write(payload);
+        return 0;
+    }
+    if (format === 'markdown' || format === 'md') {
+        const md = renderAcceptanceReplayMarkdown(replay);
+        if (output)
+            writeOutputFile(cwd, output, md);
+        else
+            process.stdout.write(md);
+        return 0;
+    }
+    const text = renderAcceptanceReplayText(replay);
+    if (output)
+        writeOutputFile(cwd, output, text);
+    else
+        process.stdout.write(text);
+    return 0;
+}
+export const changesCommand = {
+    name: 'changes',
+    description: 'Changes summary — grouped diff over --since/--staged/--files. Supports --round label and `changes acceptance-replay`. Read-only.',
+    usage: 'shrk changes <summary|impact|report|acceptance-replay> [--since <ref>] [--staged] [--files a,b,c] [--round <name>] [--profile changed-only|standard|strict] [--format text|markdown|json] [--output <file>]',
+    async run(args) {
+        const sub = args.positional[0];
+        const sliced = { ...args, positional: args.positional.slice(1) };
+        if (sub === 'summary' || sub === undefined)
+            return runChangesSummary(sliced.positional.length > 0 ? sliced : args);
+        if (sub === 'report')
+            return runChangesSummary(sliced);
+        if (sub === 'impact')
+            return runChangesSummary(sliced);
+        if (sub === 'acceptance-replay' || sub === 'replay' || sub === 'acceptance') {
+            return runChangesAcceptanceReplay(sliced);
+        }
+        process.stderr.write('Usage: shrk changes <summary|impact|report|acceptance-replay> [--since <ref>] [--staged] [--files a,b,c] [--round <name>]\n');
+        return 2;
+    },
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.command.d.ts","sourceRoot":"","sources":["../../src/commands/check.command.ts"],"names":[],"mappings":"AAoBA,OAAO,EAML,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AA0kBhC,eAAO,MAAM,YAAY,EAAE,eAmD1B,CAAC"}