@osovv/grace-cli 3.2.0 → 3.3.0

package/README.md

@@ -10,13 +10,13 @@ This repository packages GRACE as reusable skills for coding agents. The current
 - knowledge-graph synchronization
 - controller-managed sequential or multi-agent implementation
 
-Current packaged version: `3.2.0`
+Current packaged version: `3.3.0`
 
 ## What Changed In This Version
 
-- Documented the published Bun-powered `grace` CLI more explicitly across skills and repo context.
-- Added `grace lint` guidance as a fast integrity preflight alongside reviewer, refresh, and status workflows.
-- Updated the public install example to use `bun add -g @osovv/grace-cli`.
+- Removed profile selection from `grace lint`; the CLI now validates only against the current GRACE artifact set.
+- Limited `.grace-lint.json` to the current config schema, such as `ignoredDirs`.
+- Kept the role-aware/adaptive lint model while making older GRACE repos fail loudly until they are updated.
 
 ## Repository Layout
 
@@ -215,16 +215,11 @@ Optional repository config file:
 
 ```json
 {
-  "profile": "auto",
   "ignoredDirs": ["tmp"]
 }
 ```
 
-Profiles:
-
-- `auto` => require `docs/verification-plan.xml` only when the repo already looks verification-aware
-- `current` => require current GRACE artifacts
-- `legacy` => allow older GRACE repos without a verification plan
+`grace lint` is current-only. Older GRACE repositories should fail until they are updated to the current artifact set, especially `docs/verification-plan.xml`.
 
 The validator checks marketplace/plugin metadata sync, version consistency, required fields, `.claude-plugin` structure, and hardcoded absolute paths. In branch or PR context it scopes validation to changed plugins via `git diff origin/main...HEAD`; otherwise it validates all plugins.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/grace-cli",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "GRACE CLI for linting semantic markup, contracts, and GRACE XML artifacts with a Bun-powered grace binary.",
   "license": "MIT",
   "homepage": "https://github.com/osovv/grace-marketplace#readme",

package/src/grace-lint.ts

@@ -6,7 +6,6 @@ import { formatTextReport, isValidTextFormat, lintGraceProject } from "./lint/co
 import type { LintOptions, LintResult } from "./lint/types";
 
 export type {
-  EffectiveProfile,
   GraceLintConfig,
   LanguageAdapter,
   LanguageAnalysis,
@@ -16,7 +15,6 @@ export type {
   LintSeverity,
   MapMode,
   ModuleRole,
-  RepoProfile,
 } from "./lint/types";
 
 export { formatTextReport, lintGraceProject } from "./lint/core";
@@ -48,11 +46,6 @@ export const lintCommand = defineCommand({
       description: "Output format: text or json",
       default: "text",
     },
-    profile: {
-      type: "string",
-      description: "Lint profile: auto, current, or legacy",
-      default: "auto",
-    },
     allowMissingDocs: {
       type: "boolean",
       description: "Allow repositories that do not yet have full GRACE docs",
@@ -67,7 +60,6 @@ export const lintCommand = defineCommand({
 
     const result = lintGraceProject(String(context.args.path ?? "."), {
       allowMissingDocs: Boolean(context.args.allowMissingDocs),
-      profile: String(context.args.profile ?? "auto") as LintOptions["profile"],
     });
 
     writeResult(format, result);

package/src/grace.ts

@@ -7,7 +7,7 @@ import { lintCommand } from "./grace-lint";
 const main = defineCommand({
   meta: {
     name: "grace",
-    version: "3.2.0",
+    version: "3.3.0",
     description: "GRACE CLI for linting semantic markup and GRACE project artifacts.",
   },
   subCommands: {

package/src/lint/config.ts

@@ -4,7 +4,7 @@ import path from "node:path";
 import type { GraceLintConfig, LintIssue } from "./types";
 
 const CONFIG_FILE_NAME = ".grace-lint.json";
-const VALID_PROFILES = new Set(["auto", "current", "legacy"]);
+const SUPPORTED_KEYS = new Set(["ignoredDirs"]);
 
 export function loadGraceLintConfig(projectRoot: string) {
   const configPath = path.join(projectRoot, CONFIG_FILE_NAME);
@@ -16,12 +16,26 @@ export function loadGraceLintConfig(projectRoot: string) {
     const parsed = JSON.parse(readFileSync(configPath, "utf8")) as GraceLintConfig;
     const issues: LintIssue[] = [];
 
-    if (parsed.profile && !VALID_PROFILES.has(parsed.profile)) {
+    if (!parsed || Array.isArray(parsed) || typeof parsed !== "object") {
       issues.push({
         severity: "error",
-        code: "config.invalid-profile",
+        code: "config.invalid-shape",
         file: CONFIG_FILE_NAME,
-        message: `Unsupported profile \`${parsed.profile}\` in ${CONFIG_FILE_NAME}. Use \`auto\`, \`current\`, or \`legacy\`.`,
+        message: `${CONFIG_FILE_NAME} must contain a JSON object.`,
+      });
+      return { config: parsed, issues };
+    }
+
+    for (const key of Object.keys(parsed)) {
+      if (SUPPORTED_KEYS.has(key)) {
+        continue;
+      }
+
+      issues.push({
+        severity: "error",
+        code: "config.unknown-key",
+        file: CONFIG_FILE_NAME,
+        message: `Unsupported key \`${key}\` in ${CONFIG_FILE_NAME}. Supported keys: ignoredDirs.`,
       });
     }
 

package/src/lint/core.ts

@@ -4,7 +4,6 @@ import path from "node:path";
 import { loadGraceLintConfig } from "./config";
 import { getLanguageAdapter } from "./adapters/base";
 import type {
-  EffectiveProfile,
   GraceLintConfig,
   LanguageAnalysis,
   LintIssue,
@@ -15,13 +14,9 @@ import type {
   ModuleContractInfo,
   ModuleMapItem,
   ModuleRole,
-  RepoProfile,
 } from "./types";
 
-const REQUIRED_DOCS_BY_PROFILE: Record<EffectiveProfile, string[]> = {
-  legacy: ["docs/knowledge-graph.xml", "docs/development-plan.xml"],
-  current: ["docs/knowledge-graph.xml", "docs/development-plan.xml", "docs/verification-plan.xml"],
-};
+const REQUIRED_DOCS = ["docs/knowledge-graph.xml", "docs/development-plan.xml", "docs/verification-plan.xml"] as const;
 
 const OPTIONAL_PACKET_DOC = "docs/operational-packets.xml";
 const LINT_CONFIG_FILE = ".grace-lint.json";
@@ -557,46 +552,6 @@ function lintRequiredPacketSections(result: LintResult, relativePath: string, te
   }
 }
 
-function resolveProfile(
-  requestedProfile: RepoProfile | undefined,
-  configProfile: RepoProfile | undefined,
-  docs: Record<string, string | null>,
-) {
-  const desiredProfile = requestedProfile ?? configProfile ?? "auto";
-  if (desiredProfile !== "auto") {
-    return desiredProfile;
-  }
-
-  const verificationPlan = docs["docs/verification-plan.xml"];
-  if (verificationPlan) {
-    return "current" as const;
-  }
-
-  const joinedDocs = `${docs["docs/knowledge-graph.xml"] ?? ""}\n${docs["docs/development-plan.xml"] ?? ""}`;
-  return /<verification-ref>|<V-M-/.test(joinedDocs) ? "current" : "legacy";
-}
-
-function validateProfileSelection(profile: string | undefined) {
-  if (!profile) {
-    return null;
-  }
-
-  if (profile === "auto" || profile === "current" || profile === "legacy") {
-    return null;
-  }
-
-  return {
-    severity: "error",
-    code: "config.invalid-profile-selection",
-    file: "CLI",
-    message: `Unsupported profile \`${profile}\`. Use \`auto\`, \`current\`, or \`legacy\`.`,
-  } satisfies LintIssue;
-}
-
-function isInvalidProfileIssue(issue: LintIssue) {
-  return issue.code === "config.invalid-profile" || issue.code === "config.invalid-profile-selection";
-}
-
 function lintExportMapParity(
   result: LintResult,
   relativePath: string,
@@ -771,11 +726,6 @@ function lintGovernedFile(result: LintResult, root: string, filePath: string, te
 export function lintGraceProject(projectRoot: string, options: LintOptions = {}): LintResult {
   const root = path.resolve(projectRoot);
   const { config, issues: configIssues } = loadGraceLintConfig(root);
-  const requestedProfileIssue = validateProfileSelection(options.profile as string | undefined);
-  const effectiveRequestedProfile = requestedProfileIssue ? undefined : options.profile;
-  const effectiveConfigProfile = configIssues.some((issue) => issue.code === "config.invalid-profile")
-    ? undefined
-    : config?.profile;
 
   const docs = {
     "docs/knowledge-graph.xml": readTextIfExists(path.join(root, "docs/knowledge-graph.xml")),
@@ -783,29 +733,26 @@ export function lintGraceProject(projectRoot: string, options: LintOptions = {})
     "docs/verification-plan.xml": readTextIfExists(path.join(root, "docs/verification-plan.xml")),
   } satisfies Record<string, string | null>;
 
-  const profile = resolveProfile(effectiveRequestedProfile, effectiveConfigProfile, docs);
   const result: LintResult = {
     root,
-    profile,
     filesChecked: 0,
     governedFiles: 0,
     xmlFilesChecked: 0,
-    issues: [...configIssues, ...(requestedProfileIssue ? [requestedProfileIssue] : [])],
+    issues: [...configIssues],
   };
 
-  if (configIssues.some((issue) => issue.severity === "error" && issue.file === LINT_CONFIG_FILE && !isInvalidProfileIssue(issue))) {
+  if (configIssues.some((issue) => issue.severity === "error" && issue.file === LINT_CONFIG_FILE)) {
     return result;
   }
 
-  const requiredDocs = REQUIRED_DOCS_BY_PROFILE[profile];
   if (!options.allowMissingDocs) {
-    for (const relativePath of requiredDocs) {
+    for (const relativePath of REQUIRED_DOCS) {
       if (!docs[relativePath]) {
         addIssue(result, {
           severity: "error",
           code: "docs.missing-required-artifact",
           file: relativePath,
-          message: `Missing required GRACE artifact \`${relativePath}\` for the ${profile} profile.`,
+          message: `Missing required current GRACE artifact \`${relativePath}\`.`,
         });
       }
     }
@@ -928,7 +875,6 @@ export function formatTextReport(result: LintResult) {
     "GRACE Lint Report",
     "=================",
     `Root: ${result.root}`,
-    `Profile: ${result.profile}`,
     `Code files checked: ${result.filesChecked}`,
     `Governed files checked: ${result.governedFiles}`,
     `XML files checked: ${result.xmlFilesChecked}`,

package/src/lint/types.ts

@@ -1,8 +1,5 @@
 export type LintSeverity = "error" | "warning";
 
-export type RepoProfile = "auto" | "current" | "legacy";
-export type EffectiveProfile = Exclude<RepoProfile, "auto">;
-
 export type ModuleRole = "RUNTIME" | "TEST" | "BARREL" | "CONFIG" | "TYPES" | "SCRIPT";
 export type MapMode = "EXPORTS" | "LOCALS" | "SUMMARY" | "NONE";
 
@@ -16,7 +13,6 @@ export type LintIssue = {
 
 export type LintResult = {
   root: string;
-  profile: EffectiveProfile;
   filesChecked: number;
   governedFiles: number;
   xmlFilesChecked: number;
@@ -25,11 +21,9 @@ export type LintResult = {
 
 export type LintOptions = {
   allowMissingDocs?: boolean;
-  profile?: RepoProfile;
 };
 
 export type GraceLintConfig = {
-  profile?: RepoProfile;
   ignoredDirs?: string[];
 };