my-patina 0.3.0 → 0.5.0

package/dist/cli.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 
+// src/cli.ts
+import { Command } from "commander";
+
 // src/wizard.ts
 import * as p from "@clack/prompts";
 import chalk from "chalk";
@@ -80,9 +83,9 @@ var linkedinModule = {
   managedPaths: LI_MANAGED_PATHS,
   contentFileNames: CONTENT_FILE_NAMES,
   managedFiles(vars) {
-    const files = LI_COMMANDS.map((cmd2) => [
-      `.claude/commands/${cmd2}`,
-      render(tpl(`modules/linkedin/commands/${cmd2}`), vars)
+    const files = LI_COMMANDS.map((cmd) => [
+      `.claude/commands/${cmd}`,
+      render(tpl(`modules/linkedin/commands/${cmd}`), vars)
     ]);
     files.push([
       ".claude/modules/linkedin/manifest.md",
@@ -239,6 +242,23 @@ function touch(targetDir, relativePath) {
   mkdirSync2(dirname3(full), { recursive: true });
   writeFileSync3(full, "", "utf8");
 }
+var MANIFEST_REQUIRED_FIELDS = ["name", "label", "reflect_hook", "description", "installed"];
+function extractFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  const parsed = yaml2.load(match[1]);
+  if (typeof parsed !== "object" || parsed === null) return null;
+  return parsed;
+}
+function validateManifestFrontmatter(moduleName, content) {
+  const fm = extractFrontmatter(content);
+  if (!fm) throw new Error(`Module "${moduleName}" manifest has missing or unparseable frontmatter`);
+  for (const field of MANIFEST_REQUIRED_FIELDS) {
+    if (!fm[field]) {
+      throw new Error(`Module "${moduleName}" manifest is missing required field "${field}"`);
+    }
+  }
+}
 function profileToVars(profile, liProfileUrl) {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return {
@@ -326,6 +346,10 @@ async function scaffold(opts) {
     ...baseManagedFiles(vars, editor, targetDir),
     ...modules.flatMap((m) => moduleManagedFiles(m, vars))
   ];
+  for (const module of modules) {
+    const manifestEntry = managedFiles.find(([p2]) => p2 === `.claude/modules/${module}/manifest.md`);
+    if (manifestEntry) validateManifestFrontmatter(module, manifestEntry[1]);
+  }
   for (const [relativePath, content] of managedFiles) {
     const { checksum } = writeManagedFile(targetDir, relativePath, content, {});
     checksums[relativePath] = checksum;
@@ -991,10 +1015,15 @@ function onCancel() {
   process.exit(0);
 }
 
+// src/commands/index.ts
+function registerCommands(_program) {
+}
+
 // src/cli.ts
 import chalk2 from "chalk";
-var [cmd] = process.argv.slice(2);
-if (cmd === "validate") {
+var program = new Command();
+program.name("patina").description("Personal professional knowledge graph \u2014 setup and management");
+program.command("validate").description("Check your patina for broken links and excluded items").action(() => {
   try {
     const cwd = process.cwd();
     const root = findPatinaRoot(cwd);
@@ -1006,7 +1035,7 @@ if (cmd === "validate") {
     const result = validate(root, profile);
     const report = formatReport(result);
     const lines = report.split("\n");
-    const summary = lines.pop();
+    const summary = lines.pop() ?? "";
     if (lines.length > 0) console.log(lines.join("\n"));
     console.log(result.ok ? chalk2.green(summary) : chalk2.red(summary));
     process.exit(result.ok ? 0 : 1);
@@ -1014,9 +1043,20 @@ if (cmd === "validate") {
     console.error(chalk2.red(err instanceof Error ? err.message : String(err)));
     process.exit(1);
   }
-} else {
+});
+registerCommands(program);
+program.action(function() {
+  if (this.args.length > 0) {
+    console.error(chalk2.red(`Unknown command: ${this.args[0]}`));
+    console.error(chalk2.dim("Run 'patina --help' for available commands."));
+    process.exit(1);
+  }
   main().catch((err) => {
     console.error(err.message);
     process.exit(1);
   });
-}
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(chalk2.red(err instanceof Error ? err.message : String(err)));
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-patina",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Personal professional knowledge graph — setup and management",
   "type": "module",
   "bin": {
@@ -20,6 +20,7 @@
   "dependencies": {
     "@clack/prompts": "^0.9.0",
     "chalk": "^5.3.0",
+    "commander": "^12.1.0",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {