@thehumanpatternlab/hpl 0.0.1-alpha.6 → 1.0.0

package/README.md

@@ -1,173 +1,182 @@
-<!--
-  HPL CLI
-  The Human Pattern Lab
-
-  This README is written for humans.
-  Design rationale lives in DESIGN.md.
--->
-
-# HPL CLI (Alpha) 🧭🦊
-
-![AI-Forward CLI](https://img.shields.io/badge/AI--Forward%20CLI-black?style=flat-square)
-![automation-safe by design](https://img.shields.io/badge/automation--safe%20by%20design-8b5cf6?style=flat-square)
-![npm (alpha)](https://img.shields.io/npm/v/@thehumanpatternlab/hpl/alpha?label=alpha&color=8b5cf6&style=flat-square)
-![Carmel Judgment](https://github.com/AdaInTheLab/the-human-pattern-lab-cli/actions/workflows/carmel-judgment.yml/badge.svg)
-
-> **Status:** Alpha  
-> A modern, automation-safe CLI for The Human Pattern Lab.
-
-**HPL** is the official command-line interface for **The Human Pattern Lab**.
-
-Formerly developed under the codename **Skulk**, HPL is built to work just as well for humans at the keyboard as it does for automation, CI, and agent-driven workflows.
-
-This package is in **active alpha development**. Interfaces are stabilizing, but iteration is expected.
-
----
-
-## What HPL Connects To
-
-HPL is a deterministic bridge between:
-
-- the **Human Pattern Lab Content Repository** (source of truth)
-- the **Human Pattern Lab API** (runtime index and operations)
-
-Written content lives as Markdown in a dedicated content repository.  
-The API syncs and indexes that content so it can be rendered by user interfaces.
-
-By default, HPL targets a Human Pattern Lab API instance. You can override the API endpoint with `--base-url` to use staging or a self-hosted deployment of the same API.
-
-> Note: `--base-url` is intended for alternate deployments of the Human Pattern Lab API, not arbitrary third-party APIs.
-
----
-
-## Authentication
-
-HPL supports token-based authentication via the `HPL_TOKEN` environment variable.
-
-```bash
-export HPL_TOKEN="your-api-token"
-```
-
-(Optional) Override the API endpoint:
-
-```bash
-export HPL_BASE_URL="https://api.thehumanpatternlab.com"
-```
-
-> `HPL_BASE_URL` should point to the **root** of a Human Pattern Lab API deployment.  
-> Do not include additional path segments.
-
-Some API endpoints may require authentication depending on server configuration.
-
----
-
-## Quick Start
-
-### Install (alpha)
-
-```bash
-npm install -g @thehumanpatternlab/hpl@alpha
-```
-
-### Sync Lab Notes from the content repository
-
-```bash
-hpl notes sync --content-repo AdaInTheLab/the-human-pattern-lab-content
-```
-
-This pulls structured Markdown content from the repository and synchronizes it into the Human Pattern Lab system.
-
-### Machine-readable output
-
-```bash
-hpl --json notes sync
-```
-
----
-
-## Content Source Configuration (Optional)
-
-By default, `notes sync` expects a content repository with the following structure:
-
-```text
-labnotes/
-  en/
-    *.md
-  ko/
-    *.md
-```
-
-You may pin a default content repository using an environment variable:
-
-```bash
-export HPL_CONTENT_REPO="AdaInTheLab/the-human-pattern-lab-content"
-```
-
-This allows `hpl notes sync` to run without explicitly passing `--content-repo`.
-
----
-
-## Commands
-
-```text
-hpl <domain> <action> [options]
-```
-
-### notes
-
-- `hpl notes list`
-- `hpl notes get <slug>`
-- `hpl notes sync --content-repo <owner/name|url>`
-- `hpl notes sync --dir <path>` (advanced / local development)
-
-### health
-
-```bash
-hpl health
-```
-
-### version
-
-```bash
-hpl version
-```
-
----
-
-## JSON Output Contract
-
-Structured output is treated as a **contract**, not a courtesy.
-
-When `--json` is provided:
-
-- stdout contains **only valid JSON**
-- stderr is used for logs and diagnostics
-- exit codes are deterministic
-
-A verification step is included:
-
-```bash
-npm run json:check
-```
-
-This command fails if any non-JSON output appears on stdout.
-
----
-
-## What HPL Is Not
-
-HPL is not:
-- a chatbot interface
-- an agent framework
-- a memory system
-- an inference layer
-
-It is a command-line tool for interacting with Human Pattern Lab systems in a predictable, human-owned way.
-
----
-
-**The Human Pattern Lab**  
-https://thehumanpatternlab.com
-
-*The lantern is lit.  
-The foxes are watching.*
+<!--
+  HPL CLI
+  The Human Pattern Lab
+
+  This README is written for humans.
+  Design rationale lives in DESIGN.md.
+-->
+
+# HPL CLI (Alpha) 🧭🦊
+
+![AI-Forward CLI](https://img.shields.io/badge/AI--Forward%20CLI-black?style=flat-square)
+![automation-safe by design](https://img.shields.io/badge/automation--safe%20by%20design-8b5cf6?style=flat-square)
+![npm (alpha)](https://img.shields.io/npm/v/@thehumanpatternlab/hpl/alpha?label=alpha&color=8b5cf6&style=flat-square)
+![Carmel Judgment](https://github.com/AdaInTheLab/the-human-pattern-lab-cli/actions/workflows/carmel-judgment.yml/badge.svg)
+
+> **Status:** Alpha  
+> A modern, automation-safe CLI for The Human Pattern Lab.
+
+**HPL** is the official command-line interface for **The Human Pattern Lab**.
+
+Formerly developed under the codename **Skulk**, HPL is built to work just as well for humans at the keyboard as it does for automation, CI, and agent-driven workflows.
+
+This package is in **active alpha development**. Interfaces are stabilizing, but iteration is expected.
+
+---
+
+## What HPL Connects To
+
+HPL is a deterministic bridge between:
+
+- the **Human Pattern Lab Content Repository** (source of truth)
+- the **Human Pattern Lab API** (runtime index and operations)
+
+Written content lives as Markdown in a dedicated content repository.  
+The API syncs and indexes that content so it can be rendered by user interfaces.
+
+By default, HPL targets a Human Pattern Lab API instance. You can override the API endpoint with `--base-url` to use staging or a self-hosted deployment of the same API.
+
+> Note: `--base-url` is intended for alternate deployments of the Human Pattern Lab API, not arbitrary third-party APIs.
+
+---
+
+## Authentication
+
+HPL supports token-based authentication via the `HPL_TOKEN` environment variable.
+
+```bash
+export HPL_TOKEN="your-api-token"
+```
+
+(Optional) Override the API endpoint:
+
+```bash
+export HPL_BASE_URL="https://api.thehumanpatternlab.com"
+```
+
+> `HPL_BASE_URL` should point to the **root** of a Human Pattern Lab API deployment.  
+> Do not include additional path segments.
+
+Some API endpoints may require authentication depending on server configuration.
+
+---
+
+## Quick Start
+
+### Install (alpha)
+
+```bash
+npm install -g @thehumanpatternlab/hpl@alpha
+```
+
+### Sync Lab Notes from the content repository
+
+```bash
+hpl notes sync --content-repo AdaInTheLab/the-human-pattern-lab-content
+```
+
+This pulls structured Markdown content from the repository and synchronizes it into the Human Pattern Lab system.
+
+### Machine-readable output
+
+```bash
+hpl --json notes sync
+```
+
+---
+
+## Content Source Configuration (Optional)
+
+By default, `notes sync` expects a content repository with the following structure:
+
+```text
+labnotes/
+  en/
+    *.md
+  ko/
+    *.md
+```
+
+You may pin a default content repository using an environment variable:
+
+```bash
+export HPL_CONTENT_REPO="AdaInTheLab/the-human-pattern-lab-content"
+```
+
+This allows `hpl notes sync` to run without explicitly passing `--content-repo`.
+
+---
+
+## Commands
+
+```text
+hpl <domain> <action> [options]
+```
+
+### notes
+
+**Read operations:**
+- `hpl notes list` - List all published Lab Notes
+- `hpl notes get <slug>` - Get a specific Lab Note by slug
+
+**Write operations:** (requires `HPL_TOKEN`)
+- `hpl notes create --title "..." --slug "..." --file note.md` - Create a new Lab Note
+- `hpl notes update <slug> --title "..." --file note.md` - Update an existing Lab Note
+
+**Bulk operations:**
+- `hpl notes sync --content-repo <owner/name|url>` - Sync from content repository
+- `hpl notes sync --dir <path>` - Sync from local directory (advanced / local development)
+
+See [WRITE_OPERATIONS_GUIDE.md](./WRITE_OPERATIONS_GUIDE.md) for detailed write operations documentation.
+
+### health
+
+```bash
+hpl health
+```
+
+### version
+
+```bash
+hpl version
+```
+
+---
+
+## JSON Output Contract
+
+Structured output is treated as a **contract**, not a courtesy.
+
+When `--json` is provided:
+
+- stdout contains **only valid JSON**
+- stderr is used for logs and diagnostics
+- exit codes are deterministic
+
+A verification step is included:
+
+```bash
+npm run json:check
+```
+
+This command fails if any non-JSON output appears on stdout.
+
+---
+
+## What HPL Is Not
+
+HPL is not:
+- a chatbot interface
+- an agent framework
+- a memory system
+- an inference layer
+
+It is a command-line tool for interacting with Human Pattern Lab systems in a predictable, human-owned way.
+
+---
+
+**The Human Pattern Lab**  
+https://thehumanpatternlab.com
+
+*The lantern is lit.  
+The foxes are watching.*

package/dist/src/commands/notes/create.js

@@ -0,0 +1,183 @@
+/* ===========================================================
+   🦊 THE HUMAN PATTERN LAB — HPL CLI
+   -----------------------------------------------------------
+   File: create.ts
+   Role: Notes subcommand: `hpl notes create`
+   Author: Ada (The Human Pattern Lab)
+   Assistant: Claude
+   Lab Unit: SCMS — Systems & Code Management Suite
+   Status: Active
+   -----------------------------------------------------------
+   Purpose:
+     Create a new Lab Note via API using the upsert endpoint.
+     Supports both markdown file input and inline content.
+   -----------------------------------------------------------
+   Design:
+     - Core function returns { envelope, exitCode }
+     - Commander adapter decides json vs human rendering
+     - Requires authentication via HPL_TOKEN
+   =========================================================== */
+import fs from "node:fs";
+import { Command } from "commander";
+import { getOutputMode, printJson } from "../../cli/output.js";
+import { renderText } from "../../render/text.js";
+import { LabNoteUpsertSchema } from "../../types/labNotes.js";
+import { HPL_TOKEN } from "../../lib/config.js";
+import { getAlphaIntent } from "../../contract/intents.js";
+import { ok, err } from "../../contract/envelope.js";
+import { EXIT } from "../../contract/exitCodes.js";
+import { postJson, HttpError } from "../../http/client.js";
+/**
+ * Core: create a new Lab Note.
+ * Returns structured envelope + exitCode (no printing here).
+ */
+export async function runNotesCreate(options, commandName = "notes.create") {
+    const intent = getAlphaIntent("create_lab_note");
+    // Authentication check
+    const token = HPL_TOKEN();
+    if (!token) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_AUTH",
+                message: "Authentication required. Set HPL_TOKEN environment variable or configure token in ~/.humanpatternlab/hpl.json",
+            }),
+            exitCode: EXIT.AUTH,
+        };
+    }
+    // Get markdown content
+    let markdown;
+    if (options.file) {
+        if (!fs.existsSync(options.file)) {
+            return {
+                envelope: err(commandName, intent, {
+                    code: "E_NOT_FOUND",
+                    message: `File not found: ${options.file}`,
+                }),
+                exitCode: EXIT.NOT_FOUND,
+            };
+        }
+        try {
+            markdown = fs.readFileSync(options.file, "utf-8");
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                envelope: err(commandName, intent, {
+                    code: "E_IO",
+                    message: `Failed to read file: ${msg}`,
+                }),
+                exitCode: EXIT.IO,
+            };
+        }
+    }
+    else if (options.markdown) {
+        markdown = options.markdown;
+    }
+    else {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_VALIDATION",
+                message: "Either --markdown or --file is required",
+            }),
+            exitCode: EXIT.VALIDATION,
+        };
+    }
+    // Build payload
+    const payload = {
+        slug: options.slug,
+        title: options.title,
+        markdown,
+        locale: options.locale,
+        subtitle: options.subtitle,
+        summary: options.summary,
+        tags: options.tags,
+        published: options.published,
+        status: options.status,
+        type: options.type,
+        dept: options.dept,
+    };
+    // Validate payload
+    const parsed = LabNoteUpsertSchema.safeParse(payload);
+    if (!parsed.success) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_VALIDATION",
+                message: "Invalid note data",
+                details: parsed.error.flatten(),
+            }),
+            exitCode: EXIT.VALIDATION,
+        };
+    }
+    // Make API request
+    try {
+        const response = await postJson("/lab-notes/upsert", parsed.data, token);
+        return {
+            envelope: ok(commandName, intent, {
+                slug: response.slug,
+                action: response.action ?? "created",
+                message: `Lab Note ${response.action ?? "created"}: ${response.slug}`,
+            }),
+            exitCode: EXIT.OK,
+        };
+    }
+    catch (e) {
+        if (e instanceof HttpError) {
+            if (e.status === 401 || e.status === 403) {
+                return {
+                    envelope: err(commandName, intent, {
+                        code: "E_AUTH",
+                        message: "Authentication failed. Check your HPL_TOKEN.",
+                    }),
+                    exitCode: EXIT.AUTH,
+                };
+            }
+            const code = e.status && e.status >= 500 ? "E_SERVER" : "E_HTTP";
+            return {
+                envelope: err(commandName, intent, {
+                    code,
+                    message: `API request failed (${e.status ?? "unknown"})`,
+                    details: e.body ? e.body.slice(0, 500) : undefined,
+                }),
+                exitCode: e.status && e.status >= 500 ? EXIT.SERVER : EXIT.NETWORK,
+            };
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_UNKNOWN",
+                message: msg,
+            }),
+            exitCode: EXIT.UNKNOWN,
+        };
+    }
+}
+/**
+ * Commander: `hpl notes create`
+ */
+export function notesCreateSubcommand() {
+    return new Command("create")
+        .description("Create a new Lab Note (contract: create_lab_note)")
+        .requiredOption("--title <title>", "Note title")
+        .requiredOption("--slug <slug>", "Note slug (unique identifier)")
+        .option("--markdown <text>", "Markdown content (inline)")
+        .option("--file <path>", "Path to markdown file")
+        .option("--locale <code>", "Locale code (default: en)", "en")
+        .option("--subtitle <text>", "Note subtitle")
+        .option("--summary <text>", "Note summary")
+        .option("--tags <tags>", "Comma-separated tags", (val) => val.split(",").map((t) => t.trim()))
+        .option("--published <date>", "Publication date (ISO format)")
+        .option("--status <status>", "Note status (draft|published|archived)", "draft")
+        .option("--type <type>", "Note type (labnote|paper|memo|lore|weather)", "labnote")
+        .option("--dept <dept>", "Department code")
+        .action(async (opts, cmd) => {
+        const mode = getOutputMode(cmd);
+        const { envelope, exitCode } = await runNotesCreate(opts, "notes.create");
+        if (mode === "json") {
+            printJson(envelope);
+        }
+        else {
+            renderText(envelope);
+        }
+        process.exitCode = exitCode;
+    });
+}

package/dist/src/commands/notes/notes.js

@@ -22,11 +22,15 @@ import { Command } from "commander";
 import { notesListSubcommand } from "./list.js";
 import { notesGetSubcommand } from "./get.js";
 import { notesSyncSubcommand } from "./notesSync.js";
+import { notesCreateSubcommand } from "./create.js";
+import { notesUpdateSubcommand } from "./update.js";
 export function notesCommand() {
     const notes = new Command("notes").description("Lab Notes commands");
     // Subcommands
     notes.addCommand(notesListSubcommand());
     notes.addCommand(notesGetSubcommand());
+    notes.addCommand(notesCreateSubcommand());
+    notes.addCommand(notesUpdateSubcommand());
     notes.addCommand(notesSyncSubcommand());
     return notes;
 }

package/dist/src/commands/notes/update.js

@@ -0,0 +1,217 @@
+/* ===========================================================
+   🦊 THE HUMAN PATTERN LAB — HPL CLI
+   -----------------------------------------------------------
+   File: update.ts
+   Role: Notes subcommand: `hpl notes update`
+   Author: Ada (The Human Pattern Lab)
+   Assistant: Claude
+   Lab Unit: SCMS — Systems & Code Management Suite
+   Status: Active
+   -----------------------------------------------------------
+   Purpose:
+     Update an existing Lab Note via API using the upsert endpoint.
+     Supports both markdown file input and inline content.
+   -----------------------------------------------------------
+   Design:
+     - Core function returns { envelope, exitCode }
+     - Commander adapter decides json vs human rendering
+     - Requires authentication via HPL_TOKEN
+     - Uses upsert endpoint (same as create)
+   =========================================================== */
+import fs from "node:fs";
+import { Command } from "commander";
+import { getOutputMode, printJson } from "../../cli/output.js";
+import { renderText } from "../../render/text.js";
+import { LabNoteUpsertSchema } from "../../types/labNotes.js";
+import { HPL_TOKEN } from "../../lib/config.js";
+import { getAlphaIntent } from "../../contract/intents.js";
+import { ok, err } from "../../contract/envelope.js";
+import { EXIT } from "../../contract/exitCodes.js";
+import { postJson, HttpError } from "../../http/client.js";
+/**
+ * Core: update an existing Lab Note.
+ * Returns structured envelope + exitCode (no printing here).
+ */
+export async function runNotesUpdate(options, commandName = "notes.update") {
+    const intent = getAlphaIntent("update_lab_note");
+    // Authentication check
+    const token = HPL_TOKEN();
+    if (!token) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_AUTH",
+                message: "Authentication required. Set HPL_TOKEN environment variable or configure token in ~/.humanpatternlab/hpl.json",
+            }),
+            exitCode: EXIT.AUTH,
+        };
+    }
+    // Get markdown content if provided
+    let markdown;
+    if (options.file) {
+        if (!fs.existsSync(options.file)) {
+            return {
+                envelope: err(commandName, intent, {
+                    code: "E_NOT_FOUND",
+                    message: `File not found: ${options.file}`,
+                }),
+                exitCode: EXIT.NOT_FOUND,
+            };
+        }
+        try {
+            markdown = fs.readFileSync(options.file, "utf-8");
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                envelope: err(commandName, intent, {
+                    code: "E_IO",
+                    message: `Failed to read file: ${msg}`,
+                }),
+                exitCode: EXIT.IO,
+            };
+        }
+    }
+    else if (options.markdown) {
+        markdown = options.markdown;
+    }
+    // For updates, we need at least title OR markdown
+    if (!options.title && !markdown) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_VALIDATION",
+                message: "Must provide at least --title or --markdown/--file for update",
+            }),
+            exitCode: EXIT.VALIDATION,
+        };
+    }
+    // Build payload - use required fields from what's provided
+    // The API will handle partial updates if it supports them, 
+    // or we provide what we have
+    const payload = {
+        slug: options.slug,
+    };
+    if (options.title)
+        payload.title = options.title;
+    if (markdown)
+        payload.markdown = markdown;
+    if (options.locale)
+        payload.locale = options.locale;
+    if (options.subtitle)
+        payload.subtitle = options.subtitle;
+    if (options.summary)
+        payload.summary = options.summary;
+    if (options.tags)
+        payload.tags = options.tags;
+    if (options.published)
+        payload.published = options.published;
+    if (options.status)
+        payload.status = options.status;
+    if (options.type)
+        payload.type = options.type;
+    if (options.dept)
+        payload.dept = options.dept;
+    // The upsert endpoint requires title and markdown
+    // For an update operation, if these aren't provided, we should fetch the existing note first
+    if (!payload.title || !payload.markdown) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_VALIDATION",
+                message: "Update requires both --title and (--markdown or --file). For partial updates, use the API directly or fetch the existing note first.",
+            }),
+            exitCode: EXIT.VALIDATION,
+        };
+    }
+    // Validate payload
+    const parsed = LabNoteUpsertSchema.safeParse(payload);
+    if (!parsed.success) {
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_VALIDATION",
+                message: "Invalid note data",
+                details: parsed.error.flatten(),
+            }),
+            exitCode: EXIT.VALIDATION,
+        };
+    }
+    // Make API request
+    try {
+        const response = await postJson("/lab-notes/upsert", parsed.data, token);
+        return {
+            envelope: ok(commandName, intent, {
+                slug: response.slug,
+                action: response.action ?? "updated",
+                message: `Lab Note ${response.action ?? "updated"}: ${response.slug}`,
+            }),
+            exitCode: EXIT.OK,
+        };
+    }
+    catch (e) {
+        if (e instanceof HttpError) {
+            if (e.status === 401 || e.status === 403) {
+                return {
+                    envelope: err(commandName, intent, {
+                        code: "E_AUTH",
+                        message: "Authentication failed. Check your HPL_TOKEN.",
+                    }),
+                    exitCode: EXIT.AUTH,
+                };
+            }
+            if (e.status === 404) {
+                return {
+                    envelope: err(commandName, intent, {
+                        code: "E_NOT_FOUND",
+                        message: `No lab note found for slug: ${options.slug}`,
+                    }),
+                    exitCode: EXIT.NOT_FOUND,
+                };
+            }
+            const code = e.status && e.status >= 500 ? "E_SERVER" : "E_HTTP";
+            return {
+                envelope: err(commandName, intent, {
+                    code,
+                    message: `API request failed (${e.status ?? "unknown"})`,
+                    details: e.body ? e.body.slice(0, 500) : undefined,
+                }),
+                exitCode: e.status && e.status >= 500 ? EXIT.SERVER : EXIT.NETWORK,
+            };
+        }
+        const msg = e instanceof Error ? e.message : String(e);
+        return {
+            envelope: err(commandName, intent, {
+                code: "E_UNKNOWN",
+                message: msg,
+            }),
+            exitCode: EXIT.UNKNOWN,
+        };
+    }
+}
+/**
+ * Commander: `hpl notes update`
+ */
+export function notesUpdateSubcommand() {
+    return new Command("update")
+        .description("Update an existing Lab Note (contract: update_lab_note)")
+        .argument("<slug>", "Note slug to update")
+        .option("--title <title>", "Note title")
+        .option("--markdown <text>", "Markdown content (inline)")
+        .option("--file <path>", "Path to markdown file")
+        .option("--locale <code>", "Locale code")
+        .option("--subtitle <text>", "Note subtitle")
+        .option("--summary <text>", "Note summary")
+        .option("--tags <tags>", "Comma-separated tags", (val) => val.split(",").map((t) => t.trim()))
+        .option("--published <date>", "Publication date (ISO format)")
+        .option("--status <status>", "Note status (draft|published|archived)")
+        .option("--type <type>", "Note type (labnote|paper|memo|lore|weather)")
+        .option("--dept <dept>", "Department code")
+        .action(async (slug, opts, cmd) => {
+        const mode = getOutputMode(cmd);
+        const { envelope, exitCode } = await runNotesUpdate({ ...opts, slug }, "notes.update");
+        if (mode === "json") {
+            printJson(envelope);
+        }
+        else {
+            renderText(envelope);
+        }
+        process.exitCode = exitCode;
+    });
+}

package/dist/src/contract/exitCodes.js

@@ -14,6 +14,8 @@ export const EXIT = {
     NOT_FOUND: 3, // 404 semantics
     AUTH: 4, // auth required / invalid token
     FORBIDDEN: 5, // insufficient scope/permission
+    VALIDATION: 6, // data validation failed
+    IO: 7, // file I/O errors
     NETWORK: 10, // DNS/timeout/unreachable
     SERVER: 11, // 5xx or unexpected response
     CONTRACT: 12, // schema mismatch / invalid JSON contract

package/dist/src/contract/intents.js

@@ -40,6 +40,20 @@ export const INTENTS_ALPHA = {
         sideEffects: [],
         reversible: true,
     },
+    create_lab_note: {
+        intent: "create_lab_note",
+        intentVersion: "1",
+        scope: ["lab_notes", "remote_api"],
+        sideEffects: ["write_remote"],
+        reversible: false,
+    },
+    update_lab_note: {
+        intent: "update_lab_note",
+        intentVersion: "1",
+        scope: ["lab_notes", "remote_api"],
+        sideEffects: ["write_remote"],
+        reversible: false,
+    },
 };
 export function getAlphaIntent(id) {
     return INTENTS_ALPHA[id];

package/dist/src/http/client.js

@@ -37,3 +37,29 @@ export async function getJson(path, signal) {
     const payload = (await res.json());
     return unwrap(payload);
 }
+export async function postJson(path, body, token, signal) {
+    const { apiBaseUrl } = getConfig();
+    const url = apiBaseUrl + path;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (token) {
+        headers["Authorization"] = `Bearer ${token}`;
+    }
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        signal,
+    });
+    if (!res.ok) {
+        let responseBody = "";
+        try {
+            responseBody = await res.text();
+        }
+        catch { /* ignore */ }
+        throw new HttpError(`POST ${path} failed`, res.status, responseBody);
+    }
+    const payload = (await res.json());
+    return unwrap(payload);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehumanpatternlab/hpl",
-  "version": "0.0.1-alpha.6",
+  "version": "1.0.0",
   "description": "AI-forward, automation-safe SDK and CLI for the Human Pattern Lab",
   "type": "module",
   "license": "MIT",