@dot-skill/workspace 0.4.2 → 0.5.0

package/README.md

@@ -0,0 +1,45 @@
+# `@dot-skill/workspace`
+
+Local working tree for authoring `.skill` packages — sections, stage, compile, checkpoint, and mint.
+
+Git-like layout under `.skill/`. Agents propose sections; humans stage and approve; compile produces a continuity draft or a release package.
+
+## Install
+
+```bash
+npm i @dot-skill/workspace
+```
+
+Typically used via [`skillerr`](https://www.npmjs.com/package/skillerr) (`skill init`, `propose`, `checkpoint`, `compile`, `load`).
+
+## Layout
+
+```text
+.skill/
+  config.json
+  sections/*.json
+  index.json          # staged ids
+  HEAD.json
+  objects/*.skill
+```
+
+| Concept | Command (CLI) |
+|---------|----------------|
+| init | `skill init` |
+| propose | `skill propose` (agent + `SKILL_HOST`) |
+| stage | `skill add` |
+| status | `skill status` |
+| handoff | `skill checkpoint` |
+| release | `skill compile --approve --mint` |
+| resume | `skill load` |
+
+## Related
+
+- [`@dot-skill/core`](https://www.npmjs.com/package/@dot-skill/core) — compile / mint
+- [`skillerr`](https://www.npmjs.com/package/skillerr) — public install / user-facing CLI
+
+Docs: [WORKSPACE.md](https://github.com/dot-skill/dot-skill/blob/main/docs/WORKSPACE.md) · [CONTINUITY.md](https://github.com/dot-skill/dot-skill/blob/main/docs/CONTINUITY.md)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -103,6 +103,8 @@ export interface CompileWorkspaceOptions {
     mint?: boolean;
     profile?: SkillCompileProfile;
     host?: string;
+    agent_runtime?: string;
+    agent_version?: string;
     generation_usage?: GenerationUsage;
     input_tokens?: number;
     output_tokens?: number;

package/dist/index.js

@@ -10,7 +10,7 @@
  *     objects/<id>.skill       # continuity drafts / release packages
  */
 import { mkdir, readFile, writeFile, readdir, unlink } from "node:fs/promises";
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 import { isValidAgentHost, PROTOCOL_VERSION } from "@dot-skill/protocol";
@@ -22,7 +22,8 @@ function id(prefix) {
 export function requireAgentHost(host) {
     const h = host ?? process.env.SKILL_HOST;
     if (!isValidAgentHost(h)) {
-        throw new Error("AI agent provenance required. Set SKILL_HOST=cursor|ollama|lmstudio|llama-cpp|custom-agent|… (local models are supported).");
+        throw new Error("AI agent provenance required. Set SKILL_HOST=cursor|ollama|lmstudio|llama-cpp|custom-agent|… " +
+            "(not human/cli/shell/manual). Env alone never yields verified_issuer trust.");
     }
     return h;
 }
@@ -286,6 +287,14 @@ async function toSkillSource(root, staged, title, profile, usage, hostOverride)
         source_protocol_version: PROTOCOL_VERSION,
     };
 }
+function loadWorkspaceIdentity() {
+    const metadata = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+    if (typeof metadata.name !== "string" || typeof metadata.version !== "string") {
+        throw new Error("Invalid @dot-skill/workspace package metadata");
+    }
+    return { name: metadata.name, version: metadata.version };
+}
+const WORKSPACE_IDENTITY = loadWorkspaceIdentity();
 /**
  * Continuity checkpoint — partial OK, privacy-scrubbed handoff draft.
  */
@@ -350,6 +359,10 @@ export async function compileWorkspace(root, opts = {}) {
         if (profile !== "release") {
             throw new Error("Mint only allowed with --profile release (not continuity drafts).");
         }
+        const agentRuntime = process.env.SKILL_AGENT_RUNTIME ?? opts.agent_runtime ?? WORKSPACE_IDENTITY.name;
+        const agentVersion = process.env.SKILL_AGENT_VERSION ??
+            opts.agent_version ??
+            (agentRuntime === WORKSPACE_IDENTITY.name ? WORKSPACE_IDENTITY.version : "unknown");
         const sealed = mintSkillPackage(compiled.files, {
             host: requireAgentHost(opts.host),
             provider: process.env.SKILL_PROVIDER,
@@ -359,7 +372,8 @@ export async function compileWorkspace(root, opts = {}) {
                 ? redactSecrets(process.env.SKILL_ENDPOINT)
                 : undefined,
             actors: [process.env.SKILL_ACTOR ?? "human"],
-            agent_runtime: process.env.SKILL_AGENT_RUNTIME ?? "@dot-skill/cli",
+            agent_runtime: agentRuntime,
+            agent_version: agentVersion,
         });
         bytes = sealed.packageBytes;
         compiled = { ...compiled, files: sealed.files, packageBytes: sealed.packageBytes };

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "@dot-skill/workspace",
-  "version": "0.4.2",
-  "description": "Git-like local .skill workspace — sections, stage, compile, checkpoint, mint",
+  "version": "0.5.0",
+  "description": "Local workspace for sections, stage, compile, checkpoint, and mint",
   "license": "MIT",
   "author": {
     "name": "Bharat Dudeja",
     "url": "https://github.com/bharatdudeja13-cmd"
   },
+  "keywords": [
+    "skill",
+    "dot-skill",
+    ".skill",
+    "ai-agents",
+    "agent-skills",
+    "workspace",
+    "continuity"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,6 +27,10 @@
     "url": "https://github.com/dot-skill/dot-skill.git",
     "directory": "packages/workspace"
   },
+  "homepage": "https://github.com/dot-skill/dot-skill#readme",
+  "bugs": {
+    "url": "https://github.com/dot-skill/dot-skill/issues"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -25,15 +38,17 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json",
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@dot-skill/core": "^0.4.2",
-    "@dot-skill/protocol": "^0.4.2"
+    "@dot-skill/core": "^0.5.0",
+    "@dot-skill/protocol": "^0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.21",