laconic-skill 0.1.0

package/README.md

@@ -0,0 +1,43 @@
+npx laconic-skill check output.txt --receipt
+
+# laconic-skill
+
+Install and run in one command:
+
+```bash
+npx laconic-skill check output.txt --receipt
+cat output.txt | npx laconic-skill check - --receipt
+```
+
+Or install globally:
+
+```bash
+npm install -g laconic-skill
+laconic check output.txt --receipt
+```
+
+## What It Does
+
+`laconic-skill` checks a text answer for concise Laconic output rules and can emit a tamper-evident CLI receipt.
+
+Checks:
+
+- direct answer, no filler opening
+- complete answer, no trailing ellipsis
+- brief answer
+- no Markdown bold
+
+## Commands
+
+```bash
+laconic-skill --help
+laconic-skill check output.txt
+laconic-skill check output.txt --receipt
+laconic check output.txt --receipt
+```
+
+`--receipt` implies JSON output with checks, metrics, answer hash, and receipt hash.
+
+Failed checks exit `1` but still emit receipt JSON when `--receipt` is used.
+
+Receipts are tamper-evident CLI receipts. They are not factual verification and do not prove the answer is true.

package/bin/laconic-skill.mjs

@@ -0,0 +1,171 @@
+#!/usr/bin/env node
+
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+
+const VERSION = "0.1.0";
+const FILLER_PREFIXES = [
+  "sure",
+  "certainly",
+  "of course",
+  "absolutely",
+  "as an ai",
+  "i'd be happy to",
+  "i can help",
+];
+
+function printHelp() {
+  console.log(`laconic-skill ${VERSION}
+
+Usage:
+  npx laconic-skill check <file> --receipt
+  npx laconic-skill check - --receipt
+  laconic check <file> --receipt
+
+Commands:
+  check <file>       Check an answer file for laconic output quality.
+  check -            Read answer text from stdin.
+
+Options:
+  --receipt          Include a tamper-evident JSON receipt.
+  --json             Print JSON only.
+  -h, --help         Show this help.
+  -v, --version      Show version.
+`);
+}
+
+function sha256(text) {
+  return createHash("sha256").update(text).digest("hex");
+}
+
+function stableJson(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableJson).join(",")}]`;
+  }
+  if (value && typeof value === "object") {
+    return `{${Object.keys(value)
+      .sort()
+      .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)
+      .join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function countWords(text) {
+  const matches = text.trim().match(/\S+/g);
+  return matches ? matches.length : 0;
+}
+
+function readingTimeSeconds(text) {
+  return Math.max(1, Math.ceil((countWords(text) / 225) * 60));
+}
+
+function runChecks(answer) {
+  const trimmed = answer.trim();
+  const normalized = trimmed.toLowerCase();
+  const hasMarkdownBold = /\*\*[^*]+\*\*|__[^_]+__/.test(answer);
+  const direct = normalized.length > 0 && !FILLER_PREFIXES.some((prefix) => normalized.startsWith(prefix));
+  const complete = normalized.length > 0 && !normalized.endsWith("...");
+  const brief = countWords(answer) <= 120;
+
+  return {
+    direct,
+    complete,
+    brief,
+    no_markdown_bold: !hasMarkdownBold,
+  };
+}
+
+function buildReceipt({ file, answer, checks }) {
+  const timestamp = new Date().toISOString();
+  const canonical = {
+    tool: "laconic-skill",
+    version: VERSION,
+    file: basename(file),
+    answer_hash: sha256(answer),
+    answer_length: countWords(answer),
+    reading_time_seconds: readingTimeSeconds(answer),
+    checks,
+    timestamp,
+  };
+
+  return {
+    ...canonical,
+    receipt_hash: sha256(stableJson(canonical)),
+  };
+}
+
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+function getInputTarget(args) {
+  return args.find((arg) => arg === "-" || !arg.startsWith("-"));
+}
+
+async function checkCommand(args) {
+  const file = getInputTarget(args);
+  const includeReceipt = args.includes("--receipt");
+  const jsonOnly = args.includes("--json");
+
+  if (!file) {
+    throw new Error("Missing file. Usage: laconic-skill check <file> --receipt");
+  }
+
+  const answer = file === "-" ? await readStdin() : await readFile(file, "utf8");
+  const checks = runChecks(answer);
+  const passed = Object.values(checks).every(Boolean);
+  const result = {
+    ok: passed,
+    file,
+    checks,
+    metrics: {
+      answer_length: countWords(answer),
+      reading_time_seconds: readingTimeSeconds(answer),
+    },
+  };
+
+  if (includeReceipt) {
+    result.receipt = buildReceipt({ file, answer, checks });
+  }
+
+  if (jsonOnly || includeReceipt) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(passed ? "OK" : "FAILED");
+    for (const [name, value] of Object.entries(checks)) {
+      console.log(`${name}: ${value}`);
+    }
+  }
+
+  process.exitCode = passed ? 0 : 1;
+}
+
+async function main() {
+  const [, , command, ...args] = process.argv;
+
+  if (!command || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+  if (command === "--version" || command === "-v") {
+    console.log(VERSION);
+    return;
+  }
+  if (command === "check") {
+    await checkCommand(args);
+    return;
+  }
+
+  throw new Error(`Unknown command: ${command}`);
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "laconic-skill",
+  "version": "0.1.0",
+  "description": "A command-line checker for Laconic answers and tamper-evident receipts.",
+  "type": "module",
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "bin": {
+    "laconic-skill": "bin/laconic-skill.mjs",
+    "laconic": "bin/laconic-skill.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "laconic",
+    "receipt",
+    "cli",
+    "answer-checker"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electricwolfemarshmallowhypertext/laco.git",
+    "directory": "packages/laconic-skill"
+  },
+  "homepage": "https://github.com/electricwolfemarshmallowhypertext/laco/tree/master/packages/laconic-skill#readme",
+  "bugs": {
+    "url": "https://github.com/electricwolfemarshmallowhypertext/laco/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}