@anchorlock/cli 0.0.0-stage → 0.2.0

package/lib/demo.js

@@ -0,0 +1,48 @@
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const CONTRACT = {
+  schemaVersion: '1',
+  units: [
+    {
+      id: 'order_no',
+      type: 'string',
+      aliases: ['orderId', 'order_sn', '订单编号', '单号'],
+    },
+    { id: 'trade_no', type: 'string' },
+  ],
+};
+
+/** init 落盘：空名单。字段从本次任务写，不要塞 demo 订单字段。 */
+const STARTER = {
+  schemaVersion: '1',
+  units: [],
+};
+
+const DRIFT = 'export function row() {\n  return { orderId: "A10086", order_sn: "S1" };\n}\n';
+const ALIGNED = 'export function row() {\n  return { order_no: "A10086", trade_no: "T1" };\n}\n';
+
+/**
+ * @param {(opts: object) => Promise<object>} checkNames
+ */
+async function runDemo(checkNames) {
+  const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'anchorlock-demo-'));
+  try {
+    const src = path.join(tmp, 'src');
+    fs.mkdirSync(src);
+    const contract = path.join(tmp, 'constraints.json');
+    fs.writeFileSync(contract, JSON.stringify(CONTRACT, null, 2) + '\n');
+    fs.writeFileSync(path.join(src, 'order.js'), DRIFT);
+    const red = await checkNames({ contract: contract, src: src, relRoot: tmp });
+    fs.writeFileSync(path.join(src, 'order.js'), ALIGNED);
+    const green = await checkNames({ contract: contract, src: src, relRoot: tmp });
+    return { red: red, green: green };
+  } finally {
+    fs.rmSync(tmp, { recursive: true, force: true });
+  }
+}
+
+module.exports = { runDemo, CONTRACT, STARTER, DRIFT, ALIGNED };

package/lib/engine.js

@@ -0,0 +1,36 @@
+'use strict';
+
+const path = require('path');
+
+function loadEngine() {
+  const tried = [];
+  const candidates = [
+    path.resolve(__dirname, '../../anchorlock-core'),
+    '@anchorlock/core',
+  ];
+  for (let i = 0; i < candidates.length; i++) {
+    const id = candidates[i];
+    try {
+      const spec = require(id);
+      if (
+        spec &&
+        typeof spec.checkNames === 'function' &&
+        typeof spec.draftIds === 'function' &&
+        typeof spec.writeConstraintsFromOpenApi === 'function' &&
+        typeof spec.draftConstraintsFromCode === 'function' &&
+        typeof spec.writePin === 'function'
+      ) {
+        return spec;
+      }
+      tried.push(id + ' (missing checkNames/draftIds/writeConstraintsFromOpenApi; need >= 0.5.17)');
+    } catch (e) {
+      tried.push(id + ' (' + (e && e.code ? e.code : e.message) + ')');
+    }
+  }
+  throw new Error(
+    'Anchorlock needs @anchorlock/core >= 0.6.0 (checkNames / pin / constraints).\n  tried: ' +
+      tried.join('\n  tried: '),
+  );
+}
+
+module.exports = { loadEngine };

package/lib/install-agent.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+function skillSourcePath() {
+  return path.join(__dirname, '..', 'skills', 'anchorlock', 'SKILL.md');
+}
+
+function readSkill() {
+  return fs.readFileSync(skillSourcePath(), 'utf8');
+}
+
+function installAgentFiles(root, opts) {
+  opts = opts || {};
+  const dests = [
+    path.join(root, '.cursor', 'skills', 'anchorlock', 'SKILL.md'),
+    path.join(root, '.claude', 'skills', 'anchorlock', 'SKILL.md'),
+  ];
+  const body = readSkill();
+  const written = [];
+  dests.forEach(function (dest) {
+    if (!opts.dryRun) {
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, body, 'utf8');
+    }
+    written.push(dest);
+  });
+  const agents = path.join(root, 'AGENTS.md');
+  const stamp =
+    '\n## AnchorLock\n\n消费仓对照钉死的 OpenAPI（`contracts/*.pin.json`）收紧字段名：`npx anchor check --contract contracts/order.pin.json --src src --strict --require-hash`。没有说明书时，一处 `anchor init --from-code` 起草，**人确认**后再 check；不要从需求/PRD 编写名单。要用新字段等后端发新 tag，由人 `anchor repin --tag vX.Y.Z --change <需求号>` 整份换；不要为了绿灯 repin 或改 pin。多 Agent 共享同一份 pin，不是每人一份名单。抛锚是 SemanticAnchor 的 `bind` / `verify_usage`，不是这条 check。\n';
+  if (!opts.dryRun) {
+    if (!fs.existsSync(agents)) {
+      fs.writeFileSync(agents, '# Agent\n' + stamp, 'utf8');
+    } else {
+      const cur = fs.readFileSync(agents, 'utf8');
+      if (cur.indexOf('AnchorLock') === -1) {
+        fs.appendFileSync(agents, stamp, 'utf8');
+      }
+    }
+  }
+  written.push(agents);
+  return { skill: dests, agents: agents, written: written };
+}
+
+module.exports = { skillSourcePath, readSkill, installAgentFiles };

package/lib/term.js

@@ -0,0 +1,45 @@
+'use strict';
+
+let forceOff = false;
+
+function setNoColor(v) {
+  forceOff = !!v;
+}
+
+function supportsColor(stream) {
+  if (forceOff) return false;
+  if (process.env.NO_COLOR != null && process.env.NO_COLOR !== '') return false;
+  if (process.env.FORCE_COLOR === '0') return false;
+  if (process.env.FORCE_COLOR && process.env.FORCE_COLOR !== '0') return true;
+  const s = stream || process.stdout;
+  return !!(s && s.isTTY);
+}
+
+function paint(codes, text, stream) {
+  const s = String(text == null ? '' : text);
+  if (!supportsColor(stream)) return s;
+  const seq = Array.isArray(codes) ? codes.join(';') : String(codes);
+  return '\u001b[' + seq + 'm' + s + '\u001b[0m';
+}
+
+const bold = function (t, stream) { return paint(1, t, stream); };
+const dim = function (t, stream) { return paint(2, t, stream); };
+const green = function (t, stream) { return paint(32, t, stream); };
+const red = function (t, stream) { return paint(31, t, stream); };
+const cyan = function (t, stream) { return paint(36, t, stream); };
+
+function quote(name) {
+  return '"' + name + '"';
+}
+
+module.exports = {
+  setNoColor,
+  supportsColor,
+  paint,
+  bold,
+  dim,
+  green,
+  red,
+  cyan,
+  quote,
+};

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@anchorlock/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Field-name gate: consumer repos vs a pinned OpenAPI.",
+  "bin": {
+    "anchor": "./bin/anchor.js"
+  },
+  "main": "lib/cli.js",
+  "files": [
+    "bin",
+    "lib",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "docs",
+    "public/index.html",
+    "ci",
+    "skills"
+  ],
+  "scripts": {
+    "test": "node scripts/run-tests.js",
+    "demo": "node bin/anchor.js demo",
+    "preview": "npx --yes serve public -l 4174",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@anchorlock/core": "^0.6.0"
+  },
+  "homepage": "https://www.npmjs.com/package/@anchorlock/cli",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "ai",
+    "contract",
+    "field-names",
+    "lint",
+    "ci",
+    "openapi"
+  ],
+  "license": "MIT"
+}