nomark-engine 0.1.0

package/dist/index.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import * as fs from "fs";
+import * as path from "path";
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var GREEN = "\x1B[32m";
+var CYAN = "\x1B[36m";
+var YELLOW = "\x1B[33m";
+var LEDGER_FILE = "nomark-ledger.jsonl";
+function today() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function seedLedger() {
+  const meta = {
+    profile: {},
+    signals: 0,
+    by_ctx: {},
+    by_out: {},
+    avg_conf: 0,
+    avg_q: 0,
+    updated: today()
+  };
+  return `[sig:meta] ${JSON.stringify(meta)}
+`;
+}
+var AI_CONTEXT = `## nomark-engine \u2014 Preference Resolver
+
+This project uses \`@nomark-ai/engine\` to resolve user preferences from a portable JSONL ledger.
+
+### Ledger location
+\`./nomark-ledger.jsonl\` \u2014 each line is \`[sig:TYPE] {json}\`. Five signal types:
+- **pref** \u2014 learned preferences (dimension + target + weight, max 20)
+- **map** \u2014 meaning maps: natural language trigger \u2192 structured intent (max 10)
+- **asn** \u2014 field defaults with accuracy tracking (max 5)
+- **meta** \u2014 session metadata and aggregate stats (max 1)
+- **rub** \u2014 rubrics with graduated trust levels (max 4)
+
+Total capacity: 40 entries (~3 KB). The ledger is the source of truth for personalization.
+
+### Quick usage
+
+\`\`\`typescript
+import { createResolver, parseLedger } from '@nomark-ai/engine'
+import * as fs from 'fs'
+
+const ledger = fs.readFileSync('./nomark-ledger.jsonl', 'utf8')
+const resolver = createResolver({ ledgerContent: ledger, context: 'code' })
+const result = resolver.resolveAll()
+
+for (const [dim, res] of Object.entries(result.dimensions)) {
+  if (res.winner && !res.unstable) {
+    // Use this preference
+    console.log(\`\${dim}: \${res.winner.target}\`)
+  } else if (res.unstable) {
+    // Not enough evidence \u2014 ask the user
+    console.log(\`\${dim}: ask\`)
+  }
+}
+\`\`\`
+
+### Scoring (5 factors)
+Score = Specificity(0.30) + Evidence(0.25) + Recency(0.20) + Stability(0.15) + Portability(0.10) - contradiction_penalty
+- Score < 0.4 = unstable \u2192 recommend asking rather than assuming
+- Scope matching: \`*\` (global), \`context:code\`, \`topic:auth\`, or compound \`context:code+topic:auth\`
+
+### Importing signals
+\`\`\`bash
+npx nomark import --platform chatgpt --file export.json
+npx nomark import --platform claude --file export.json
+npx nomark profile   # view resolved preferences
+npx nomark review    # confirm low-confidence signals
+\`\`\`
+
+### Rules
+- Never modify scoring formulas without owner approval (patented)
+- Never change the JSONL ledger format (compatibility contract)
+- Ledger entries are capacity-bounded \u2014 pruning evicts lowest-utility entries`;
+function printBanner() {
+  console.log();
+  console.log(`${BOLD}  nomark-engine${RESET} ${DIM}\u2014 preference resolver setup${RESET}`);
+  console.log();
+}
+function detectProject(dir) {
+  const pkgPath = path.join(dir, "package.json");
+  if (fs.existsSync(pkgPath)) {
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      return { hasPackageJson: true, name: pkg.name ?? path.basename(dir) };
+    } catch {
+      return { hasPackageJson: true, name: path.basename(dir) };
+    }
+  }
+  return { hasPackageJson: false, name: path.basename(dir) };
+}
+function createLedger(dir) {
+  const ledgerPath = path.join(dir, LEDGER_FILE);
+  if (fs.existsSync(ledgerPath)) {
+    return "exists";
+  }
+  fs.writeFileSync(ledgerPath, seedLedger(), "utf8");
+  return "created";
+}
+function writeAIContext(dir) {
+  const candidates = [
+    ".claude/CLAUDE.md",
+    "CLAUDE.md",
+    ".cursor/rules",
+    ".github/copilot-instructions.md"
+  ];
+  for (const rel of candidates) {
+    const full = path.join(dir, rel);
+    if (fs.existsSync(full)) {
+      const existing = fs.readFileSync(full, "utf8");
+      if (existing.includes("nomark-engine")) {
+        return `already in ${rel}`;
+      }
+      fs.appendFileSync(full, "\n\n" + AI_CONTEXT + "\n", "utf8");
+      return rel;
+    }
+  }
+  return "none";
+}
+function printQuickStart(project) {
+  console.log(`${BOLD}  Quick start${RESET}`);
+  console.log();
+  if (project.hasPackageJson) {
+    console.log(`${DIM}  1.${RESET} Install the engine:`);
+    console.log(`     ${CYAN}npm install @nomark-ai/engine${RESET}`);
+  } else {
+    console.log(`${DIM}  1.${RESET} Initialize your project, then install:`);
+    console.log(`     ${CYAN}npm init -y && npm install @nomark-ai/engine${RESET}`);
+  }
+  console.log();
+  console.log(`${DIM}  2.${RESET} Import your AI history to build your ledger:`);
+  console.log(`     ${CYAN}npx nomark import --platform chatgpt --file export.json${RESET}`);
+  console.log();
+  console.log(`${DIM}  3.${RESET} View your resolved preference profile:`);
+  console.log(`     ${CYAN}npx nomark profile${RESET}`);
+  console.log();
+  console.log(`${DIM}  4.${RESET} Use in code:`);
+  console.log();
+  console.log(`${DIM}     import { createResolver } from '@nomark-ai/engine'${RESET}`);
+  console.log(`${DIM}     import * as fs from 'fs'${RESET}`);
+  console.log();
+  console.log(`${DIM}     const ledger = fs.readFileSync('./nomark-ledger.jsonl', 'utf8')${RESET}`);
+  console.log(`${DIM}     const resolver = createResolver({ ledgerContent: ledger })${RESET}`);
+  console.log(`${DIM}     const result = resolver.resolveAll()${RESET}`);
+  console.log();
+}
+function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    printBanner();
+    console.log(`  Usage: ${CYAN}npx nomark-engine${RESET} [options]`);
+    console.log();
+    console.log("  Options:");
+    console.log("    --context-only   Print AI context block to stdout (for piping)");
+    console.log("    --no-ledger      Skip ledger creation");
+    console.log("    --help           Show this help");
+    console.log();
+    return;
+  }
+  if (args.includes("--context-only")) {
+    process.stdout.write(AI_CONTEXT + "\n");
+    return;
+  }
+  const dir = process.cwd();
+  const project = detectProject(dir);
+  const skipLedger = args.includes("--no-ledger");
+  printBanner();
+  if (!skipLedger) {
+    const ledgerResult = createLedger(dir);
+    if (ledgerResult === "created") {
+      console.log(`  ${GREEN}+${RESET} Created ${BOLD}${LEDGER_FILE}${RESET} ${DIM}(seed meta entry)${RESET}`);
+    } else {
+      console.log(`  ${DIM}-${RESET} ${LEDGER_FILE} already exists ${DIM}(skipped)${RESET}`);
+    }
+  }
+  const contextTarget = writeAIContext(dir);
+  if (contextTarget === "none") {
+    console.log(`  ${YELLOW}!${RESET} No AI config found ${DIM}(CLAUDE.md, .cursor/rules, etc.)${RESET}`);
+    console.log(`    ${DIM}Run ${CYAN}npx nomark-engine --context-only >> CLAUDE.md${RESET} ${DIM}to add manually${RESET}`);
+  } else if (contextTarget.startsWith("already")) {
+    console.log(`  ${DIM}-${RESET} AI context ${contextTarget} ${DIM}(skipped)${RESET}`);
+  } else {
+    console.log(`  ${GREEN}+${RESET} Appended AI context to ${BOLD}${contextTarget}${RESET}`);
+  }
+  const gitignorePath = path.join(dir, ".gitignore");
+  if (fs.existsSync(gitignorePath)) {
+    const gitignore = fs.readFileSync(gitignorePath, "utf8");
+    if (!gitignore.includes(LEDGER_FILE)) {
+      fs.appendFileSync(gitignorePath, `
+# nomark preference ledger (contains personal signals)
+${LEDGER_FILE}
+`, "utf8");
+      console.log(`  ${GREEN}+${RESET} Added ${BOLD}${LEDGER_FILE}${RESET} to .gitignore`);
+    }
+  }
+  console.log();
+  printQuickStart(project);
+  console.log(`${DIM}  Docs: https://github.com/nomark-dev/nomark-sdk${RESET}`);
+  console.log();
+}
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "nomark-engine",
+  "version": "0.1.0",
+  "description": "Set up @nomark-ai/engine in your project — ledger, AI context, and quick-start in under 60 seconds",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "nomark-engine": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "node --test 'tests/*.test.js'",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nomark-dev/nomark-sdk",
+    "directory": "packages/create-nomark-engine"
+  },
+  "keywords": [
+    "nomark",
+    "ai",
+    "agent",
+    "preferences",
+    "setup",
+    "cli"
+  ]
+}