origem 0.2.1 → 0.3.0

package/README.md

@@ -27,6 +27,19 @@ session hooks. Running it again is how you sync.
 
 `origem help` lists every option.
 
+## Slash commands in Claude Code
+
+`connect` also installs these, so you do not have to remember the CLI:
+
+| Command | What it does |
+|---|---|
+| `/origem:sync` | Pull the newest harness revision |
+| `/origem:spec` | Open specs and what is missing to close a stage |
+| `/origem:doctor` | Check drift between harness and repo |
+| `/origem:propose` | Suggest a permanent change |
+| `/origem:capture` | Turn this session's decisions into proposals |
+| `/origem:bootstrap` | Propose a whole harness from the repo |
+
 ## What a harness is
 
 A complete Claude Code setup: instructions, rules, boundaries, memory, skills,

package/dist/index.js

@@ -636,6 +636,10 @@ function resolveApiUrl(flag) {
   const fromLock = readLock(process.cwd())?.apiUrl || void 0;
   return (flag || process.env.ORIGEM_API_URL || fromLock || readConfig().apiUrl || DEFAULT_API).replace(/\/$/, "");
 }
+function resolveConnectUrl(flag) {
+  const fromLock = readLock(process.cwd())?.apiUrl || void 0;
+  return (flag || process.env.ORIGEM_API_URL || fromLock || DEFAULT_API).replace(/\/$/, "");
+}
 function resolveKey(flag) {
   const key = flag || process.env.ORIGEM_TOKEN || readConfig().token || "";
   if (!key) {
@@ -1398,6 +1402,20 @@ the project and you edit them normally.
 | \`npx origem doctor\` | Compares the harness against this repository and reports what drifted. |
 | \`npx origem bootstrap\` | Reads the repository and proposes a whole harness (for a project without one). |
 
+## Slash commands available in this repository
+
+The user can type these directly \u2014 prefer pointing them at one instead of
+explaining a raw \`npx\` invocation:
+
+| Command | What it does |
+|---|---|
+| \`/origem:sync\` | Pull the newest harness revision |
+| \`/origem:spec\` | Open specs and what is missing to close a stage |
+| \`/origem:doctor\` | Check drift between harness and repo |
+| \`/origem:propose\` | Suggest a permanent change |
+| \`/origem:capture\` | Turn this session's decisions into proposals |
+| \`/origem:bootstrap\` | Propose a whole harness from the repo |
+
 ## At the start of a task
 
 Run \`npx origem spec\`. If there is an open spec related to what the user asked, use its
@@ -1461,6 +1479,148 @@ function installOrigemSkill(baseDir, lock) {
   ok(`Origem skill installed at ${SKILL_PATH}`);
 }
 
+// src/commands-install.ts
+import { existsSync as existsSync8, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "node:fs";
+import { dirname as dirname6, join as join7 } from "node:path";
+var COMMANDS = [
+  {
+    file: "sync.md",
+    content: `---
+description: Pull the newest harness revision from Origem and rewrite the local config files
+allowed-tools: Bash(npx origem:*)
+---
+
+Run \`npx origem status\` first and show me what would change.
+
+If any managed block was edited locally, stop and tell me before applying \u2014 the
+apply overwrites it.
+
+Otherwise run \`npx origem connect\` and report what changed.
+`
+  },
+  {
+    file: "spec.md",
+    content: `---
+description: Show the open specs and which stage each one is in
+allowed-tools: Bash(npx origem:*)
+---
+
+Run \`npx origem spec\`.
+
+Then tell me, in one short paragraph: which spec is closest to done, what is
+missing to close its current stage, and whether anything we did in this session
+already satisfies one of the acceptance criteria.
+`
+  },
+  {
+    file: "doctor.md",
+    content: `---
+description: Check whether the harness still matches this repository (drift)
+allowed-tools: Bash(npx origem:*)
+---
+
+Run \`npx origem doctor\`.
+
+For each finding, say whether fixing it is worth it and what the fix would be.
+Do not change anything yet \u2014 drift is fixed in the harness, not in local files.
+If I agree with a fix, use \`/origem:propose\` to send it.
+`
+  },
+  {
+    file: "propose.md",
+    content: `---
+description: Suggest a permanent change to the harness (stays pending until accepted)
+allowed-tools: Bash(npx origem:*)
+---
+
+Propose this change to the harness: $ARGUMENTS
+
+Before proposing:
+1. Read the current harness pieces so you do not propose something already there.
+2. Pick the right compartment \u2014 \`rule\`, \`boundary\`, \`memory\`, \`knowledge\`,
+   \`skill\`, \`agent\`, \`prompt\`, \`instruction\`, \`harness\`, \`mcp\`, \`integration\`.
+3. Write \`--why\` citing what happened in THIS session. That sentence is what
+   the reviewer reads to decide \u2014 a generic justification gets rejected.
+
+Then run \`npx origem propose\` with \`--type\`, \`--title\`, \`--content\` and \`--why\`.
+
+Propose one thing only. If there are two changes, ask me which one first.
+`
+  },
+  {
+    file: "capture.md",
+    content: `---
+description: Turn what we just decided in this conversation into a harness proposal
+allowed-tools: Bash(npx origem:*)
+---
+
+Look back over this session and find decisions that should hold in FUTURE
+sessions \u2014 a convention we settled on, a correction I made more than once, a
+command that turned out to be wrong.
+
+Ignore anything specific to the task at hand. A harness piece is only worth it
+if it would still be true next week.
+
+List what you found, one line each, and ask me which to send. For each one I
+approve, run \`npx origem propose\` with \`--why\` citing the moment in this
+session that justifies it.
+
+If you find nothing that durable, say so \u2014 proposing noise is worse than
+proposing nothing.
+`
+  },
+  {
+    file: "bootstrap.md",
+    content: `---
+description: Read this repository and propose a whole harness for it
+allowed-tools: Bash(npx origem:*)
+---
+
+Run \`npx origem bootstrap --dry-run\` and show me what it would propose.
+
+Tell me what it got right and what is missing \u2014 it reads \`package.json\`,
+\`Makefile\`, the lockfile, docs and the commit history, so it will miss anything
+that only lives in someone's head.
+
+If I approve, run \`npx origem bootstrap --yes\`, then remind me the pieces are
+PROPOSALS: nothing enters the harness until I accept the batch in Origem.
+`
+  }
+];
+var COMMANDS_DIR = join7(".claude", "commands", "origem");
+function installOrigemCommands(baseDir, lock) {
+  const fromHarness = new Set(
+    (lock?.files ?? []).map((f) => f.path.replace(/\\/g, "/"))
+  );
+  let written = 0;
+  let skipped = 0;
+  for (const cmd of COMMANDS) {
+    const rel = join7(COMMANDS_DIR, cmd.file);
+    if (fromHarness.has(rel.replace(/\\/g, "/"))) {
+      skipped++;
+      continue;
+    }
+    const abs = join7(baseDir, rel);
+    if (existsSync8(abs) && readFileSync6(abs, "utf8") === cmd.content) continue;
+    mkdirSync6(dirname6(abs), { recursive: true });
+    writeFileSync6(abs, cmd.content, "utf8");
+    written++;
+  }
+  if (written > 0) {
+    ok(`${written} slash command(s) installed in ${COMMANDS_DIR}`);
+    info(
+      color.dim(
+        `   /origem:sync  /origem:spec  /origem:doctor  /origem:propose  /origem:capture  /origem:bootstrap`
+      )
+    );
+  } else {
+    info(color.dim(`slash commands already up to date in ${COMMANDS_DIR}`));
+  }
+  if (skipped > 0) {
+    info(color.dim(`   ${skipped} kept as the harness provides them`));
+  }
+}
+
 // src/connect.ts
 var CALLBACK_TIMEOUT_MS = 5 * 60 * 1e3;
 function base64url(buf) {
@@ -1626,6 +1786,7 @@ async function runConnect(opts) {
     authorizeUrl.searchParams.set("code_challenge_method", "S256");
     authorizeUrl.searchParams.set("state", state);
     authorizeUrl.searchParams.set("scope", "read write");
+    info(`${color.cyan("\u2192")} connecting to ${color.bold(apiUrl)}`);
     info(`${color.cyan("\u2192")} opening your browser to authorise\u2026`);
     info(color.dim(`   if nothing opens, paste this in your browser:
    ${authorizeUrl.toString()}`));
@@ -1657,7 +1818,9 @@ async function runConnect(opts) {
     dryRun: false,
     yes: opts.yes
   });
-  installOrigemSkill(process.cwd(), readLock(process.cwd()));
+  const lock = readLock(process.cwd());
+  installOrigemSkill(process.cwd(), lock);
+  installOrigemCommands(process.cwd(), lock);
   if (opts.noHooks) {
     info(color.dim("hooks skipped (--no-hooks): the session will not report turns to Origem."));
   } else {
@@ -1677,7 +1840,7 @@ async function runConnect(opts) {
 }
 
 // src/propose.ts
-import { readFileSync as readFileSync6 } from "node:fs";
+import { readFileSync as readFileSync7 } from "node:fs";
 var PROPOSABLE = [
   "instruction",
   "rule",
@@ -1698,7 +1861,7 @@ async function runPropose(opts) {
   if (!opts.rationale?.trim()) {
     throw new Error("--why is required: say why you are proposing it \u2014 that is what the reviewer reads.");
   }
-  const content = opts.file ? readFileSync6(opts.file, "utf8") : opts.content ?? "";
+  const content = opts.file ? readFileSync7(opts.file, "utf8") : opts.content ?? "";
   if (!content.trim()) {
     throw new Error("Empty content. Pass --content <text> or --file <path>.");
   }
@@ -1766,8 +1929,8 @@ ${specs.length} open spec(s). When you close a stage, it is reported by \`origem
 
 // src/repo.ts
 import { execFileSync } from "node:child_process";
-import { existsSync as existsSync8, readFileSync as readFileSync7, readdirSync as readdirSync2, statSync } from "node:fs";
-import { basename as basename2, extname, join as join7, relative } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync8, readdirSync as readdirSync2, statSync } from "node:fs";
+import { basename as basename2, extname, join as join8, relative } from "node:path";
 var SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   ".git",
@@ -1788,7 +1951,7 @@ var DOC_EXT = /* @__PURE__ */ new Set([".md", ".mdx"]);
 var MAX_FILE_CHARS = 2e4;
 function read(path) {
   try {
-    return readFileSync7(path, "utf8");
+    return readFileSync8(path, "utf8");
   } catch {
     return null;
   }
@@ -1804,7 +1967,7 @@ function walk(dir, base, depth = 0, out = []) {
   for (const name of entries) {
     if (name.startsWith(".") && name !== ".github") continue;
     if (SKIP_DIRS.has(name)) continue;
-    const full = join7(dir, name);
+    const full = join8(dir, name);
     let st;
     try {
       st = statSync(full);
@@ -1820,7 +1983,7 @@ function readRepo(baseDir) {
   const files = walk(baseDir, baseDir);
   const scripts = [];
   const languages = /* @__PURE__ */ new Set();
-  const pkgRaw = read(join7(baseDir, "package.json"));
+  const pkgRaw = read(join8(baseDir, "package.json"));
   if (pkgRaw) {
     try {
       const pkg = JSON.parse(pkgRaw);
@@ -1830,14 +1993,14 @@ function readRepo(baseDir) {
     } catch {
     }
   }
-  const makefile = read(join7(baseDir, "Makefile"));
+  const makefile = read(join8(baseDir, "Makefile"));
   if (makefile) {
     for (const line of makefile.split("\n")) {
       const m = /^([a-zA-Z][\w-]*):(?!=)/.exec(line);
       if (m) scripts.push({ name: m[1], command: `make ${m[1]}`, from: "Makefile" });
     }
   }
-  const pyproject = read(join7(baseDir, "pyproject.toml"));
+  const pyproject = read(join8(baseDir, "pyproject.toml"));
   if (pyproject) languages.add("python");
   for (const f of files) {
     const ext = extname(f);
@@ -1850,8 +2013,8 @@ function readRepo(baseDir) {
     else if (ext === ".java") languages.add("java");
     else if (ext === ".cs") languages.add("csharp");
   }
-  const packageManager = existsSync8(join7(baseDir, "pnpm-lock.yaml")) ? "pnpm" : existsSync8(join7(baseDir, "yarn.lock")) ? "yarn" : existsSync8(join7(baseDir, "bun.lockb")) ? "bun" : existsSync8(join7(baseDir, "package-lock.json")) ? "npm" : null;
-  const docs = files.filter((f) => DOC_EXT.has(extname(f)) && (!f.includes("/") || f.startsWith("docs/"))).slice(0, 12).map((f) => ({ path: f, content: (read(join7(baseDir, f)) ?? "").slice(0, MAX_FILE_CHARS) })).filter((d) => d.content.trim());
+  const packageManager = existsSync9(join8(baseDir, "pnpm-lock.yaml")) ? "pnpm" : existsSync9(join8(baseDir, "yarn.lock")) ? "yarn" : existsSync9(join8(baseDir, "bun.lockb")) ? "bun" : existsSync9(join8(baseDir, "package-lock.json")) ? "npm" : null;
+  const docs = files.filter((f) => DOC_EXT.has(extname(f)) && (!f.includes("/") || f.startsWith("docs/"))).slice(0, 12).map((f) => ({ path: f, content: (read(join8(baseDir, f)) ?? "").slice(0, MAX_FILE_CHARS) })).filter((d) => d.content.trim());
   return {
     name: basename2(baseDir),
     scripts,
@@ -2255,7 +2418,7 @@ async function main() {
   switch (cmd) {
     case "connect": {
       await runConnect({
-        apiUrl: resolveApiUrl(flags.apiUrl),
+        apiUrl: resolveConnectUrl(flags.apiUrl),
         scope: flags.scope,
         // `targets` já traz o default (CLAUDE_TARGETS); passar flags.targets aqui
         // faria o apply cair no "todos os alvos" e escrever GEMINI.md, .cursor/…

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "origem",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Connect a repository to your Origem harness: authorise in the browser, write CLAUDE.md and .claude/* to disk, and keep them in sync.",
   "type": "module",
   "bin": {