@gmickel/gno 0.25.2 → 0.27.0

package/README.md

@@ -194,9 +194,11 @@ Check status: `gno mcp status`
 Skills integrate via CLI with no MCP overhead:
 
 ```bash
-gno skill install --scope user       # User-wide
-gno skill install --target codex     # Codex
-gno skill install --target all       # Both Claude + Codex
+gno skill install --scope user        # User-wide
+gno skill install --target codex      # Codex
+gno skill install --target opencode   # OpenCode
+gno skill install --target openclaw   # OpenClaw
+gno skill install --target all        # All targets
 ```
 
 > **Full setup guide**: [MCP Integration](https://gno.sh/docs/MCP/) · [CLI Reference](https://gno.sh/docs/CLI/)

package/assets/skill/SKILL.md

@@ -110,10 +110,15 @@ gno get gno://work/report.md --from 100 -l 20
 # With line numbers
 gno get gno://work/report.md --line-numbers
 
+# JSON output with capabilities metadata
+gno get gno://work/report.md --json
+
 # Multiple documents
 gno multi-get gno://work/doc1.md gno://work/doc2.md
 ```
 
+**Editable vs read-only**: `gno get --json` returns a `capabilities` field showing whether a document is editable at its source. Markdown and plain text files are editable in place. Converted documents (PDF, DOCX, XLSX) are read-only -- to edit their content, create a new markdown note instead of overwriting the binary source.
+
 ## Search Then Get (common pipeline)
 
 ```bash

package/assets/skill/cli-reference.md

@@ -488,18 +488,20 @@ Install GNO skill for AI coding assistants.
 gno skill install [options]
 ```
 
-| Option         | Default | Description                      |
-| -------------- | ------- | -------------------------------- |
-| `-t, --target` | claude  | Target: `claude`, `codex`, `amp` |
-| `-s, --scope`  | user    | Scope: `user`, `project`         |
-| `-f, --force`  | false   | Overwrite existing               |
-| `--dry-run`    | false   | Preview changes                  |
+| Option         | Default | Description                                              |
+| -------------- | ------- | -------------------------------------------------------- |
+| `-t, --target` | claude  | Target: `claude`, `codex`, `opencode`, `openclaw`, `all` |
+| `-s, --scope`  | user    | Scope: `user`, `project`                                 |
+| `-f, --force`  | false   | Overwrite existing                                       |
+| `--dry-run`    | false   | Preview changes                                          |
 
 Examples:
 
 ```bash
 gno skill install --target claude --scope project
 gno skill install --target codex --scope user
+gno skill install --target openclaw --scope user
+gno skill install --target all --force   # Install to all targets
 ```
 
 ### gno skill uninstall

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gmickel/gno",
-  "version": "0.25.2",
+  "version": "0.27.0",
   "description": "Local semantic search for your documents. Index Markdown, PDF, and Office files with hybrid BM25 + vector search.",
   "keywords": [
     "embeddings",

package/src/cli/commands/get.ts

@@ -8,6 +8,10 @@
 import type { DocumentRow, StorePort, StoreResult } from "../../store/types";
 import type { ParsedRef } from "./ref-parser";
 
+import {
+  getDocumentCapabilities,
+  type DocumentCapabilities,
+} from "../../core/document-capabilities";
 import { parseRef } from "./ref-parser";
 import { initStore } from "./shared";
 
@@ -58,6 +62,7 @@ export interface GetResponse {
     converterVersion?: string;
     mirrorHash?: string;
   };
+  capabilities: DocumentCapabilities;
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -203,6 +208,7 @@ function buildResponse(ctx: BuildResponseContext): GetResult {
         language: doc.languageHint ?? undefined,
         source: buildSourceMeta(doc, config),
         conversion: buildConversionMeta(doc),
+        capabilities: buildCapabilities(doc),
       },
     };
   }
@@ -233,6 +239,7 @@ function buildResponse(ctx: BuildResponseContext): GetResult {
       language: doc.languageHint ?? undefined,
       source: buildSourceMeta(doc, config),
       conversion: buildConversionMeta(doc),
+      capabilities: buildCapabilities(doc),
     },
   };
 }
@@ -247,6 +254,7 @@ interface DocRow {
   sourceMime: string;
   sourceExt: string;
   sourceSize: number;
+  sourceMtime?: string;
   sourceHash: string;
 }
 
@@ -262,11 +270,24 @@ function buildSourceMeta(
     relPath: doc.relPath,
     mime: doc.sourceMime,
     ext: doc.sourceExt,
+    modifiedAt: doc.sourceMtime ?? undefined,
     sizeBytes: doc.sourceSize,
     sourceHash: doc.sourceHash,
   };
 }
 
+function buildCapabilities(doc: {
+  sourceExt: string;
+  sourceMime: string;
+  mirrorHash?: string | null;
+}): DocumentCapabilities {
+  return getDocumentCapabilities({
+    sourceExt: doc.sourceExt,
+    sourceMime: doc.sourceMime,
+    contentAvailable: doc.mirrorHash !== null,
+  });
+}
+
 interface ConversionDoc {
   converterId?: string | null;
   converterVersion?: string | null;

package/src/cli/commands/skill/install.ts

@@ -13,6 +13,7 @@ import { CliError } from "../../errors.js";
 import { getGlobals } from "../../program.js";
 import {
   resolveSkillPaths,
+  SKILL_TARGETS,
   type SkillScope,
   type SkillTarget,
   validatePathForDeletion,
@@ -171,8 +172,7 @@ export async function installSkill(opts: InstallOptions = {}): Promise<void> {
   const yes = opts.yes ?? globals.yes;
   const quiet = opts.quiet ?? globals.quiet;
 
-  const targets: SkillTarget[] =
-    target === "all" ? ["claude", "codex"] : [target];
+  const targets: SkillTarget[] = target === "all" ? SKILL_TARGETS : [target];
 
   const results: InstallResult[] = [];
 

package/src/cli/commands/skill/paths.ts

@@ -1,7 +1,6 @@
 /**
  * Path resolution for skill installation.
- * Supports Claude Code and Codex targets with project/user scopes.
- * Note: OpenCode and Amp use the same .claude path as Claude Code.
+ * Supports Claude Code, Codex, OpenCode, and OpenClaw targets with project/user scopes.
  *
  * @module src/cli/commands/skill/paths
  */
@@ -22,14 +21,25 @@ export const ENV_CLAUDE_SKILLS_DIR = "CLAUDE_SKILLS_DIR";
 /** Override Codex skills directory */
 export const ENV_CODEX_SKILLS_DIR = "CODEX_SKILLS_DIR";
 
+/** Override OpenCode skills directory */
+export const ENV_OPENCODE_SKILLS_DIR = "OPENCODE_SKILLS_DIR";
+
+/** Override OpenClaw skills directory */
+export const ENV_OPENCLAW_SKILLS_DIR = "OPENCLAW_SKILLS_DIR";
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Types
 // ─────────────────────────────────────────────────────────────────────────────
 
 export type SkillScope = "project" | "user";
-export type SkillTarget = "claude" | "codex";
+export type SkillTarget = "claude" | "codex" | "opencode" | "openclaw";
 
-export const SKILL_TARGETS: SkillTarget[] = ["claude", "codex"];
+export const SKILL_TARGETS: SkillTarget[] = [
+  "claude",
+  "codex",
+  "opencode",
+  "openclaw",
+];
 
 export interface SkillPathOptions {
   scope: SkillScope;
@@ -77,6 +87,18 @@ const TARGET_CONFIGS: Record<SkillTarget, TargetPathConfig> = {
     skillsSubdir: "skills",
     envVar: ENV_CODEX_SKILLS_DIR,
   },
+  opencode: {
+    projectBase: ".opencode",
+    userBase: ".config/opencode",
+    skillsSubdir: "skills",
+    envVar: ENV_OPENCODE_SKILLS_DIR,
+  },
+  openclaw: {
+    projectBase: ".openclaw",
+    userBase: ".openclaw",
+    skillsSubdir: "skills",
+    envVar: ENV_OPENCLAW_SKILLS_DIR,
+  },
 };
 
 // ─────────────────────────────────────────────────────────────────────────────

package/src/cli/commands/skill/uninstall.ts

@@ -12,6 +12,7 @@ import { CliError } from "../../errors.js";
 import { getGlobals } from "../../program.js";
 import {
   resolveSkillPaths,
+  SKILL_TARGETS,
   type SkillScope,
   type SkillTarget,
   validatePathForDeletion,
@@ -100,8 +101,7 @@ export async function uninstallSkill(
   const json = opts.json ?? globals.json;
   const quiet = opts.quiet ?? globals.quiet;
 
-  const targets: SkillTarget[] =
-    target === "all" ? ["claude", "codex"] : [target];
+  const targets: SkillTarget[] = target === "all" ? SKILL_TARGETS : [target];
 
   const results: UninstallResult[] = [];
   const notFound: string[] = [];

package/src/cli/program.ts

@@ -1578,7 +1578,7 @@ function wireSkillCommands(program: Command): void {
     )
     .option(
       "-t, --target <target>",
-      "target agent (claude, codex, all)",
+      "target agent (claude, codex, opencode, openclaw, all)",
       "claude"
     )
     .option("-f, --force", "overwrite existing installation")
@@ -1595,17 +1595,19 @@ function wireSkillCommands(program: Command): void {
         );
       }
       // Validate target
-      if (!["claude", "codex", "all"].includes(target)) {
+      if (
+        !["claude", "codex", "opencode", "openclaw", "all"].includes(target)
+      ) {
         throw new CliError(
           "VALIDATION",
-          `Invalid target: ${target}. Must be 'claude', 'codex', or 'all'.`
+          `Invalid target: ${target}. Must be 'claude', 'codex', 'opencode', 'openclaw', or 'all'.`
         );
       }
 
       const { installSkill } = await import("./commands/skill/install.js");
       await installSkill({
         scope: scope as "project" | "user",
-        target: target as "claude" | "codex" | "all",
+        target: target as "claude" | "codex" | "opencode" | "openclaw" | "all",
         force: Boolean(cmdOpts.force),
         json: Boolean(cmdOpts.json),
       });
@@ -1621,7 +1623,7 @@ function wireSkillCommands(program: Command): void {
     )
     .option(
       "-t, --target <target>",
-      "target agent (claude, codex, all)",
+      "target agent (claude, codex, opencode, openclaw, all)",
       "claude"
     )
     .option("--json", "JSON output")
@@ -1637,17 +1639,19 @@ function wireSkillCommands(program: Command): void {
         );
       }
       // Validate target
-      if (!["claude", "codex", "all"].includes(target)) {
+      if (
+        !["claude", "codex", "opencode", "openclaw", "all"].includes(target)
+      ) {
         throw new CliError(
           "VALIDATION",
-          `Invalid target: ${target}. Must be 'claude', 'codex', or 'all'.`
+          `Invalid target: ${target}. Must be 'claude', 'codex', 'opencode', 'openclaw', or 'all'.`
         );
       }
 
       const { uninstallSkill } = await import("./commands/skill/uninstall.js");
       await uninstallSkill({
         scope: scope as "project" | "user",
-        target: target as "claude" | "codex" | "all",
+        target: target as "claude" | "codex" | "opencode" | "openclaw" | "all",
         json: Boolean(cmdOpts.json),
       });
     });
@@ -1675,7 +1679,7 @@ function wireSkillCommands(program: Command): void {
     )
     .option(
       "-t, --target <target>",
-      "filter by target (claude, codex, all)",
+      "filter by target (claude, codex, opencode, openclaw, all)",
       "all"
     )
     .option("--json", "JSON output")
@@ -1691,17 +1695,19 @@ function wireSkillCommands(program: Command): void {
         );
       }
       // Validate target
-      if (!["claude", "codex", "all"].includes(target)) {
+      if (
+        !["claude", "codex", "opencode", "openclaw", "all"].includes(target)
+      ) {
         throw new CliError(
           "VALIDATION",
-          `Invalid target: ${target}. Must be 'claude', 'codex', or 'all'.`
+          `Invalid target: ${target}. Must be 'claude', 'codex', 'opencode', 'openclaw', or 'all'.`
         );
       }
 
       const { showPaths } = await import("./commands/skill/paths-cmd.js");
       await showPaths({
         scope: scope as "project" | "user" | "all",
-        target: target as "claude" | "codex" | "all",
+        target: target as "claude" | "codex" | "opencode" | "openclaw" | "all",
         json: Boolean(cmdOpts.json),
       });
     });

package/src/core/document-capabilities.ts

@@ -0,0 +1,113 @@
+// node:path has no Bun equivalent
+import { posix as pathPosix } from "node:path";
+
+export type DocumentCapabilityMode = "editable" | "read_only";
+
+export interface DocumentCapabilities {
+  editable: boolean;
+  tagsEditable: boolean;
+  tagsWriteback: boolean;
+  canCreateEditableCopy: boolean;
+  mode: DocumentCapabilityMode;
+  reason?: string;
+}
+
+const EDITABLE_EXTENSIONS = new Set([
+  ".md",
+  ".markdown",
+  ".mdx",
+  ".txt",
+  ".text",
+]);
+
+function isTextLikeMime(mime: string): boolean {
+  return mime.startsWith("text/");
+}
+
+export function getDocumentCapabilities(input: {
+  sourceExt: string;
+  sourceMime: string;
+  contentAvailable: boolean;
+}): DocumentCapabilities {
+  const ext = input.sourceExt.toLowerCase();
+  const editable =
+    EDITABLE_EXTENSIONS.has(ext) || isTextLikeMime(input.sourceMime);
+  const tagsWriteback = ext === ".md" || ext === ".markdown" || ext === ".mdx";
+
+  if (editable) {
+    return {
+      editable: true,
+      tagsEditable: true,
+      tagsWriteback,
+      canCreateEditableCopy: false,
+      mode: "editable",
+    };
+  }
+
+  return {
+    editable: false,
+    tagsEditable: true,
+    tagsWriteback: false,
+    canCreateEditableCopy: input.contentAvailable,
+    mode: "read_only",
+    reason:
+      "This document is derived from a source format that GNO cannot safely write back in place.",
+  };
+}
+
+export function deriveEditableCopyRelPath(
+  relPath: string,
+  existingRelPaths: Iterable<string> = []
+): string {
+  const parsed = pathPosix.parse(relPath);
+  const prefix = parsed.dir ? `${parsed.dir}/` : "";
+  const baseName = parsed.name || "copy";
+  const existing = new Set(existingRelPaths);
+
+  const baseCandidate =
+    parsed.ext.toLowerCase() === ".md" ||
+    parsed.ext.toLowerCase() === ".markdown" ||
+    parsed.ext.toLowerCase() === ".mdx"
+      ? `${prefix}${baseName}.copy.md`
+      : `${prefix}${baseName}.md`;
+
+  if (!existing.has(baseCandidate)) {
+    return baseCandidate;
+  }
+
+  let counter = 2;
+  while (true) {
+    const candidate = `${prefix}${baseName}.copy-${counter}.md`;
+    if (!existing.has(candidate)) {
+      return candidate;
+    }
+    counter += 1;
+  }
+}
+
+export function buildEditableCopyContent(input: {
+  title: string;
+  sourceDocid: string;
+  sourceUri: string;
+  sourceMime: string;
+  sourceExt: string;
+  content: string;
+  tags?: string[];
+}): string {
+  const frontmatterLines = [
+    `title: ${JSON.stringify(input.title)}`,
+    `gno_source_docid: ${JSON.stringify(input.sourceDocid)}`,
+    `gno_source_uri: ${JSON.stringify(input.sourceUri)}`,
+    `gno_source_mime: ${JSON.stringify(input.sourceMime)}`,
+    `gno_source_ext: ${JSON.stringify(input.sourceExt)}`,
+  ];
+
+  if (input.tags && input.tags.length > 0) {
+    frontmatterLines.push("tags:");
+    for (const tag of input.tags) {
+      frontmatterLines.push(`  - ${JSON.stringify(tag)}`);
+    }
+  }
+
+  return `---\n${frontmatterLines.join("\n")}\n---\n\n${input.content}`;
+}

package/src/mcp/tools/get.ts

@@ -11,6 +11,10 @@ import type { ToolContext } from "../server";
 
 import { parseUri } from "../../app/constants";
 import { parseRef } from "../../cli/commands/ref-parser";
+import {
+  getDocumentCapabilities,
+  type DocumentCapabilities,
+} from "../../core/document-capabilities";
 import { runTool, type ToolResult } from "./index";
 
 interface GetInput {
@@ -42,6 +46,7 @@ interface GetResponse {
     converterVersion?: string;
     mirrorHash?: string;
   };
+  capabilities: DocumentCapabilities;
 }
 
 /**
@@ -213,6 +218,11 @@ export function handleGet(
               mirrorHash: doc.mirrorHash,
             }
           : undefined,
+        capabilities: getDocumentCapabilities({
+          sourceExt: doc.sourceExt,
+          sourceMime: doc.sourceMime,
+          contentAvailable: doc.mirrorHash !== null,
+        }),
       };
 
       return response;