@hawkeye-xb.com/imprint-cli 0.1.1 → 0.2.1

package/LICENSE

@@ -0,0 +1,94 @@
+Elastic License 2.0 (ELv2)
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set
+of the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If your company
+makes such a claim, your patent license ends immediately for work on behalf
+of your company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license
+no later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your
+licenses to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is
+the software the licensor makes available under these terms, including any
+portion of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control
+over, are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of
+an entity, or the power to direct its management and policies by vote,
+contract, or otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your
+licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/dist/cli.js

@@ -263,6 +263,68 @@ async function install(args) {
       await installCodex(creds.token, apiBase);
       break;
   }
+  await bootstrapUsageDoc(creds.token, apiBase);
+}
+var USAGE_DOC_PATH = "users/_imprint-usage.md";
+var USAGE_DOC = `# How to use Imprint (auto-seeded)
+
+This file was created by \`imprint install\` on first run as a primer for any AI agent that connects to this user's Imprint memory. Edit or \`rm\` it freely \u2014 it will only be re-seeded if missing.
+
+## Triggers
+
+- **Session start**: run \`ls /\` to see what context exists. Then \`cat\` or \`grep\` anything that might be relevant before asking the user identity questions.
+- **User reveals a preference / decision / constraint**: \`write\` it. Don't wait for explicit "remember this".
+- **Stored memory contradicts current observation**: overwrite or \`rm\` it. Stale memories are worse than missing ones.
+
+## Path taxonomy
+
+- \`users/<topic>.md\` \u2014 identity, working style, preferences, principles
+- \`projects/<name>/<topic>.md\` \u2014 per-project goals, constraints, decisions
+- \`feedback/<topic>.md\` \u2014 corrections received, validated approaches
+- \`references/<topic>.md\` \u2014 pointers to external systems (Linear, Slack, dashboards)
+
+## Entry shape
+
+Lead with the rule or fact in one line, then:
+
+- **Why:** the reason it matters (often a past incident, deadline, or stated preference)
+- **How to apply:** when this should change behavior in future sessions
+
+Knowing *why* lets future agents handle edge cases instead of mechanically following the rule.
+
+## Privacy
+
+Don't persist employer names, work emails, or any identifier that could leak day-job context unless the user has explicitly said it's safe. When in doubt, abstract ("a tech company") or omit.
+`;
+async function bootstrapUsageDoc(token, apiBase) {
+  const url = `${apiBase}/api/v1/memories/${USAGE_DOC_PATH}`;
+  try {
+    const head = await fetch(url, {
+      headers: { Authorization: `Bearer ${token}` }
+    });
+    if (head.status === 200) return;
+    if (head.status !== 404) {
+      console.warn(`  (skipped seeding ${USAGE_DOC_PATH}: HTTP ${head.status})`);
+      return;
+    }
+    const res = await fetch(`${apiBase}/api/v1/memories`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ path: USAGE_DOC_PATH, content: USAGE_DOC })
+    });
+    if (res.ok) {
+      console.log(`\u2713 Seeded ${USAGE_DOC_PATH} (visible on first \`ls /\`)`);
+    } else {
+      console.warn(`  (skipped seeding ${USAGE_DOC_PATH}: HTTP ${res.status})`);
+    }
+  } catch (err) {
+    console.warn(
+      `  (skipped seeding ${USAGE_DOC_PATH}: ${err.message})`
+    );
+  }
 }
 function parseTool(args) {
   const idx = args.indexOf("--tool");
@@ -296,13 +358,14 @@ async function mergeJsonMcpServer(filePath, serverName, serverConfig) {
   await fs2.writeFile(filePath, JSON.stringify(config, null, 2) + "\n");
 }
 async function installClaudeCode(token, apiBase) {
-  const settingsPath = path2.join(os3.homedir(), ".claude", "settings.json");
-  await mergeJsonMcpServer(settingsPath, "imprint", {
+  const configPath = path2.join(os3.homedir(), ".claude.json");
+  await mergeJsonMcpServer(configPath, "imprint", {
     type: "http",
     url: `${apiBase}/mcp`,
     headers: { Authorization: `Bearer ${token}` }
   });
-  console.log(`\u2713 Claude Code: wrote mcpServers.imprint to ${settingsPath}`);
+  console.log(`\u2713 Claude Code: wrote mcpServers.imprint to ${configPath}`);
+  console.log(`  This is user-scoped \u2014 imprint will be available from any directory.`);
   console.log(`  Restart Claude Code to pick up the new server.`);
 }
 async function installCursor(token, apiBase) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawkeye-xb.com/imprint-cli",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "type": "module",
   "description": "Imprint CLI — long-term memory for AI coding tools (Claude Code, Cursor, Codex). Installs the imprint MCP server into your tool's settings file via a browser OAuth flow.",
   "license": "Elastic-2.0",
@@ -33,16 +33,15 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "start": "node dist/cli.js",
-    "prepublishOnly": "pnpm build"
-  },
   "devDependencies": {
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/cli.js"
   }
-}
+}