@warmhub/cli 0.80.0 → 0.81.0

package/dist/wh.js

@@ -19201,11 +19201,16 @@ var isStoredContentName = (n) => STORED_CONTENT_NAMES.includes(n);
 var isSynthesizedContentName = (n) => SYNTHESIZED_CONTENT_NAMES.includes(n);
 var BUILTIN_VIEW_SHAPE_NAMES = ["View"];
 var isViewShape = (name) => BUILTIN_VIEW_SHAPE_NAMES.includes(name);
+var BUILTIN_LICENSE_SHAPE_NAMES = [
+  "LicenseSubject",
+  "LicenseDeclaration"
+];
+var isLicenseShape = (name) => BUILTIN_LICENSE_SHAPE_NAMES.includes(name);
 function isRenameableSquattedShape(name) {
-  return isReservedCollectionShape(name) || isViewShape(name);
+  return isReservedCollectionShape(name) || isViewShape(name) || isLicenseShape(name);
 }
 function isBuiltinShape(name) {
-  return BUILTIN_SHAPE_NAMES.includes(name) || BUILTIN_CONTENT_SHAPE_NAMES.includes(name) || BUILTIN_VIEW_SHAPE_NAMES.includes(name);
+  return BUILTIN_SHAPE_NAMES.includes(name) || BUILTIN_CONTENT_SHAPE_NAMES.includes(name) || BUILTIN_VIEW_SHAPE_NAMES.includes(name) || BUILTIN_LICENSE_SHAPE_NAMES.includes(name);
 }
 var BUILTIN_SHAPE_DEFS = {
   Arc: {
@@ -19271,10 +19276,63 @@ var BUILTIN_VIEW_SHAPE_DEFS = {
     description: "A named, shareable WarmQuery definition bound to durable IDs"
   }
 };
+var BUILTIN_LICENSE_SHAPE_DEFS = {
+  LicenseSubject: {
+    fields: {
+      scope: {
+        type: "string",
+        description: "What portion of the repository is being licensed"
+      },
+      "note?": {
+        type: "string",
+        description: "Optional clarification of the licensed scope"
+      }
+    },
+    description: "A licensable body of work in this repository"
+  },
+  LicenseDeclaration: {
+    fields: {
+      "licenseWref?": {
+        type: "wref",
+        description: "Canonical license reference when one license applies"
+      },
+      spdxIdRaw: {
+        type: "string",
+        description: "Declared SPDX identifier or raw license value"
+      },
+      "spdxExpression?": {
+        type: "string",
+        description: "Full SPDX expression for compound declarations"
+      },
+      "appliesTo?": {
+        type: "string",
+        description: "Kind of work covered by the declaration"
+      },
+      "attributionText?": {
+        type: "string",
+        description: "Attribution text reusers should preserve"
+      },
+      "declaredBy?": {
+        type: "string",
+        description: "Person or organization making the declaration"
+      },
+      "sourceUrl?": {
+        type: "string",
+        description: "Upstream source for the licensing terms"
+      },
+      "note?": {
+        type: "string",
+        description: "Optional declaration caveats or clarification"
+      }
+    },
+    description: "Declares the license of a LicenseSubject"
+  }
+};
 var ALL_BUILTIN_SHAPE_DEFS = {
   ...BUILTIN_SHAPE_DEFS,
   ...BUILTIN_CONTENT_SHAPE_DEFS,
-  ...BUILTIN_VIEW_SHAPE_DEFS
+  ...BUILTIN_VIEW_SHAPE_DEFS,
+  ...BUILTIN_LICENSE_SHAPE_DEFS
 };
 // ../../packages/rules/src/client-header.ts
 var CLIENT_HEADER = "X-WarmHub-Client";
@@ -28477,7 +28535,7 @@ function dedupeDeprecationsByShape(results) {
 // ../../packages/sdk-ts/package.json
 var package_default = {
   name: "@warmhub/sdk-ts",
-  version: "0.78.0",
+  version: "0.79.0",
   private: false,
   type: "module",
   description: "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -29623,6 +29681,26 @@ class WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    getLicense: async (orgName, repoName) => {
+      try {
+        return await this.trpc.repo.getLicense.query({
+          orgName,
+          repoName
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
+    describe: async (orgName, repoName) => {
+      try {
+        return await this.trpc.repo.describe.query({
+          orgName,
+          repoName
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     setReadme: async (orgName, repoName, content) => {
       try {
         assertContentWithinLimit("Content/Readme.content", content);
@@ -42875,6 +42953,42 @@ function getHttpTimeoutSnapshot() {
   return snapshot;
 }
 
+// ../../packages/warmhub-cli/src/domains/doctor-repo-license.ts
+var LICENSE_SUBSTRATE = "warmhub-data/global.reference.licenses";
+async function checkRepoLicenseDeclaration(ctx, repo, repoInfo) {
+  if (repoInfo.visibility !== "public")
+    return null;
+  const safeRepoRef = escapeTerminalTextForDisplay(repo.ref);
+  try {
+    const license = await ctx.client.repo.getLicense(repo.orgName, repo.repoName);
+    if (license) {
+      const safeSpdxId = escapeTerminalTextForDisplay(license.spdxId);
+      return {
+        key: "repo-license",
+        name: "repo-license",
+        status: "ok",
+        message: `Public repo ${safeRepoRef} declares ${safeSpdxId}`
+      };
+    }
+    return {
+      key: "repo-license",
+      name: "repo-license",
+      status: "warn",
+      message: `Public repo ${safeRepoRef} has no repository license declaration.`,
+      detail: `Choose the correct license, then create the native LicenseSubject/repo thing and LicenseDeclaration/repo assertion. Set spdxIdRaw and, when applicable, licenseWref to a canonical License in ${LICENSE_SUBSTRATE}. No component installation is required.`
+    };
+  } catch (error) {
+    const failure = classifyDoctorLookupError(error);
+    const safeDescription = escapeTerminalTextForDisplay(failure.description);
+    return {
+      key: "repo-license",
+      name: "repo-license",
+      status: "warn",
+      message: `Could not verify repository license declaration for public repo ${safeRepoRef}: ${safeDescription}`
+    };
+  }
+}
+
 // ../../packages/warmhub-cli/src/domains/doctor-checks.ts
 async function collectChecks(ctx) {
   const harnessPaths = getHarnessPaths();
@@ -42920,14 +43034,18 @@ async function collectChecks(ctx) {
     status: apiUrl ? "ok" : "fail",
     message: apiUrl ? `API URL: ${apiUrl}` : "WARMHUB_API_URL not set and no default available"
   });
-  const repo = ctx.config.defaultRepo;
-  const repoSource = ctx.config.configSource?.repo;
+  const repoFlag = getRepoRef(ctx);
+  const hasRepoFlag = repoFlag !== undefined;
+  const repo = repoFlag ?? ctx.config.defaultRepo;
+  const repoParts = repo !== undefined ? splitRepoSlug(repo) : null;
+  const repoForDisplay = repo !== undefined ? escapeTerminalTextForDisplay(repo) : undefined;
+  const repoSource = hasRepoFlag ? "flag" : ctx.config.configSource?.repo;
   const repoProvenance = repoSource === "env" ? " (from WARMHUB_REPO)" : repoSource === "wh-file" ? " (from .wh file)" : repoSource === "flag" ? " (from --repo flag)" : "";
   checks.push({
     key: "default-repo",
     name: "default-repo",
-    status: repo ? "ok" : "warn",
-    message: repo ? `Default repo: ${repo}${repoProvenance}` : "No default repo set (use --repo flag, WARMHUB_REPO, or wh use org/repo)"
+    status: repo !== undefined ? repoParts ? "ok" : "fail" : "warn",
+    message: repo !== undefined ? repoParts ? `${hasRepoFlag ? "Target" : "Default"} repo: ${repoForDisplay}${repoProvenance}` : `Invalid repo format "${repoForDisplay}". Expected "org/repo".` : "No default repo set (use --repo flag, WARMHUB_REPO, or wh use org/repo)"
   });
   const profileFlag = ctx.invocation.flags.profile;
   const profile = (typeof profileFlag === "string" ? profileFlag : undefined) ?? ctx.config.profile ?? ctx.profile ?? "default";
@@ -43035,7 +43153,8 @@ async function collectChecks(ctx) {
       });
     }
   }
-  if (repo?.includes("/")) {
+  if (repo !== undefined && repoParts) {
+    const safeRepoRef = escapeTerminalTextForDisplay(repo);
     if (!backendOk) {
       checks.push({
         key: "repo",
@@ -43044,22 +43163,25 @@ async function collectChecks(ctx) {
         message: "Skipped (backend unreachable)"
       });
     } else {
-      const [orgName, repoName] = repo.split("/", 2);
+      const { org: orgName, repo: repoName } = repoParts;
       try {
-        await ctx.client.repo.get(orgName, repoName);
+        const repoInfo = await ctx.client.repo.get(orgName, repoName);
         checks.push({
           key: "repo",
           name: "repo",
           status: "ok",
-          message: `Repo ${repo} exists`
+          message: `Repo ${safeRepoRef} exists`
         });
+        const licenseCheck = await checkRepoLicenseDeclaration(ctx, { ref: repo, orgName, repoName }, repoInfo);
+        if (licenseCheck)
+          checks.push(licenseCheck);
       } catch (e) {
         const failure = classifyDoctorLookupError(e);
         checks.push({
           key: "repo",
           name: "repo",
           status: "fail",
-          message: failure.classification === "not-found" ? `Repo ${repo} not found: ${failure.description}` : `Repo ${repo} lookup failed: ${failure.description}`
+          message: failure.classification === "not-found" ? `Repo ${safeRepoRef} not found: ${failure.description}` : `Repo ${safeRepoRef} lookup failed: ${failure.description}`
         });
       }
     }
@@ -44768,8 +44890,9 @@ var handleDescribe = async (ctx, { args, flags }) => {
   const { org, repo } = parseOrgRepo(repoRef, ctx.config);
   const c = ctx.colors;
   const showIndexedFields = flags["indexed-fields"] === true;
-  const [repoInfo, shapesPage, stats, indexedFields] = await Promise.all([
+  const [repoInfo, license, shapesPage, stats, indexedFields] = await Promise.all([
     ctx.client.repo.get(org, repo),
+    ctx.client.repo.getLicense(org, repo),
     ctx.client.shape.list(org, repo),
     ctx.client.repo.getStats(org, repo),
     showIndexedFields ? ctx.client.repo.index.describe(org, repo) : null
@@ -44792,6 +44915,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
     org,
     repo,
     description: repoInfo.description ?? null,
+    license,
     counts: {
       byKind: stats.byKind,
       byShape
@@ -44815,6 +44939,7 @@ var handleDescribe = async (ctx, { args, flags }) => {
     if (repoInfo.description) {
       ctx.out(`  ${escapeTerminalTextForDisplay(repoInfo.description)}`);
     }
+    ctx.out(`  License: ${license ? escapeTerminalTextForDisplay(license.spdxExpression ?? license.spdxId) : "not declared"}`);
     ctx.out("");
     ctx.out(`${c.bold}Counts${c.reset}  ${stats.byKind.shape} shapes, ${stats.byKind.thing} things, ${stats.byKind.assertion} assertions (${stats.total} total)`);
     const shapeCountEntries = Object.entries(byShape);
@@ -48972,7 +49097,7 @@ function resolveLogLevel(flagLevel, env) {
 // package.json
 var package_default3 = {
   name: "@warmhub/cli",
-  version: "0.80.0",
+  version: "0.81.0",
   private: false,
   type: "module",
   description: "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -49589,5 +49714,5 @@ process.exitCode = interceptedExitCode === undefined ? await runPreparedCli(laun
   version: package_default3.version
 }) : interceptedExitCode;
 
-//# debugId=3EAE1910B1B57D6664756E2164756E21
-//# warmhub-cli-build-info {"cliVersion":"0.80.0","sdkVersion":"0.78.0"}
+//# debugId=2DA8F489DEFC62BA64756E2164756E21
+//# warmhub-cli-build-info {"cliVersion":"0.81.0","sdkVersion":"0.79.0"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/cli",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "private": false,
   "type": "module",
   "description": "The wh CLI for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",