@vimhead.dev/norn-cli 0.1.0-tip.35976246970.1 → 0.1.0-tip.36148588553.1

package/assets/README.md

@@ -149,9 +149,9 @@ methods, custom providers, and Norn's configuration directory, see
 
 ### 3. Optionally connect your harness
 
-The shipped Pi and Cursor adapters deliver Norn documentation context and
+The shipped Pi, Cursor, and Claude Code adapters deliver Norn documentation context and
 [available workflow introductions](docs/cli.md#workflow-introduction) to your
-harness at session start. Installing Norn alone does not register an adapter. Claude Code, Codex,
+harness at session start. Installing Norn alone does not register an adapter. Codex
 and other harnesses can [invoke the CLI directly](docs/cli.md#javascript-client-and-other-harnesses).
 
 #### Pi
@@ -184,6 +184,32 @@ outside `PATH`, start Cursor with an executable path:
 NORN_EXECUTABLE=/absolute/path/to/norn cursor .
 ```
 
+#### Claude Code
+
+With Node and `norn` available on `PATH`, run in your terminal:
+
+```bash
+claude plugin marketplace add vimhead/norn
+claude plugin install norn@norn-adapters
+claude
+```
+
+To select a different runtime, launch Claude Code with
+`NORN_EXECUTABLE=/absolute/path/to/norn claude`. The plugin uses that runtime's
+documentation and the workflows in the session's working directory; it does not
+install Norn or configure authentication for Norn agents.
+
+Context is added on startup, `/clear`, and compaction, not again on resume or
+fork. Named-agent sessions (`--agent`) and subagent hook calls are excluded.
+Existing instructions and prompts are preserved. Introduction failures appear as
+hook errors without falling back to another runtime.
+
+To test a checkout without installing the marketplace:
+
+```bash
+claude --plugin-dir /absolute/path/to/norn
+```
+
 Need an adapter for another harness? [Open an issue](https://github.com/vimhead/norn/issues/new)
 with the harness name.
 

package/assets/package.json

@@ -1 +1 @@
-{"version":"0.1.0-tip.35976246970.1"}
+{"version":"0.1.0-tip.36148588553.1"}

package/assets/packages/cli/src/generated-build-info.ts

@@ -2,8 +2,8 @@ import type { NornBuildInfo } from "./build-info.ts";
 
 export const NORN_GENERATED_BUILD_INFO = {
   "kind": "npm-registry",
-  "version": "0.1.0-tip.35976246970.1",
-  "commit": "85fe72374183623e66290c6315b3ba51bee7a79c",
+  "version": "0.1.0-tip.36148588553.1",
+  "commit": "bef15bd5452b3202f93f33f0b33bdf07a48f7ffc",
   "packageSpec": "@vimhead.dev/norn-cli@tip",
   "upgrade": {
     "supported": false,

package/assets/packages/core/src/host-introduction.mjs

@@ -0,0 +1,36 @@
+import { execFile } from "node:child_process";
+import { Buffer } from "node:buffer";
+import { promisify } from "node:util";
+
+const runExecutable = promisify(execFile);
+const MAX_INTRO_BYTES = 16_384;
+
+function readIntroResponse({ stdout, group }) {
+	const response = JSON.parse(stdout);
+	if (
+		!response ||
+		typeof response !== "object" ||
+		typeof response.intro !== "string" ||
+		(group === "docs" && response.intro.trim().length === 0) ||
+		Buffer.byteLength(response.intro, "utf8") > MAX_INTRO_BYTES
+	)
+		throw new Error("Invalid Norn introduction response");
+	return response.intro;
+}
+
+async function loadIntroduction({ executable, cwd, group }) {
+	const { stdout } = await runExecutable(executable, [group, "intro"], {
+		cwd,
+		timeout: 10_000,
+		maxBuffer: MAX_INTRO_BYTES * 2,
+	});
+	return readIntroResponse({ stdout, group });
+}
+
+export async function loadHostIntroduction({ executable, cwd }) {
+	const [intro, workflowsIntro] = await Promise.all([
+		loadIntroduction({ executable, cwd, group: "docs" }),
+		loadIntroduction({ executable, cwd, group: "workflows" }),
+	]);
+	return `<norn-docs-intro>\n${intro}\n</norn-docs-intro>${workflowsIntro ? `\n\n${workflowsIntro}` : ""}`;
+}

package/dist/generated-build-info.d.ts

@@ -1,7 +1,7 @@
 export declare const NORN_GENERATED_BUILD_INFO: {
     readonly kind: "npm-registry";
-    readonly version: "0.1.0-tip.35976246970.1";
-    readonly commit: "85fe72374183623e66290c6315b3ba51bee7a79c";
+    readonly version: "0.1.0-tip.36148588553.1";
+    readonly commit: "bef15bd5452b3202f93f33f0b33bdf07a48f7ffc";
     readonly packageSpec: "@vimhead.dev/norn-cli@tip";
     readonly upgrade: {
         readonly supported: false;

package/dist/generated-build-info.js

@@ -1,8 +1,8 @@
 // src/generated-build-info.ts
 var NORN_GENERATED_BUILD_INFO = {
   "kind": "npm-registry",
-  "version": "0.1.0-tip.35976246970.1",
-  "commit": "85fe72374183623e66290c6315b3ba51bee7a79c",
+  "version": "0.1.0-tip.36148588553.1",
+  "commit": "bef15bd5452b3202f93f33f0b33bdf07a48f7ffc",
   "packageSpec": "@vimhead.dev/norn-cli@tip",
   "upgrade": {
     "supported": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vimhead.dev/norn-cli",
-  "version": "0.1.0-tip.35976246970.1",
+  "version": "0.1.0-tip.36148588553.1",
   "description": "Harness-agnostic runtime for agent-driven and code-driven workflows, built primarily for agents.",
   "type": "module",
   "license": "MIT",
@@ -43,7 +43,7 @@
     "@earendil-works/pi-coding-agent": "0.85.1",
     "jiti": "^2.7.0",
     "typebox": "^1.3.34",
-    "@vimhead.dev/norn": "0.1.0-tip.35976246970.1"
+    "@vimhead.dev/norn": "0.1.0-tip.36148588553.1"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.ts"