@stigmer/cli 3.19.0 → 3.20.0

package/src/registry/registry.ts

@@ -5,8 +5,9 @@
 // removed in the TypeScript migration — stigmer/stigmer#203.)
 
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { UsageError } from "../errors/index.js";
 import { generateAliases, normalizeAlias } from "./aliases.js";
-import { CLI_RELEVANT_KINDS, KIND_META } from "./metadata.js";
+import { CLI_RELEVANT_KINDS, KIND_META, RETIRED_KINDS } from "./metadata.js";
 import { Verb } from "./verbs.js";
 import { verbsForKind } from "./verb-support.js";
 
@@ -34,6 +35,21 @@ export function supportsVerb(info: TypeInfo, verb: Verb): boolean {
   return info.supportedVerbs.has(verb);
 }
 
+/**
+ * The one refusal for a YAML `kind` the registry does not know, shared by
+ * every path that reads a kind from a file (`apply -f`, `validate -f`) so
+ * the wording lives in one place. A kind the platform retired gets its own
+ * sentence (RETIRED_KINDS): the file is old, not wrong, and the user
+ * deserves the reason and the way. `where` names the file for the message.
+ */
+export function unknownKindError(yamlKind: string, where: string): UsageError {
+  const retired = RETIRED_KINDS.get(yamlKind);
+  if (retired !== undefined) {
+    return new UsageError(`kind '${yamlKind}' in ${where} ${retired}`);
+  }
+  return new UsageError(`unknown resource kind '${yamlKind}' in ${where}`);
+}
+
 export interface Registry {
   /** Look up a type by its proto kind. */
   getByKind(kind: ApiResourceKind): TypeInfo | undefined;

package/src/registry/verb-support.ts

@@ -66,19 +66,6 @@ export const VERB_SUPPORT: ReadonlyMap<
       Verb.Delete,
     ]),
   ],
-  // Project apply is the stigmer.yaml declarative/synthesis track, not
-  // `apply -f project.yaml` — resolveHandlerForKind carries the teaching
-  // refusal, and the conformance test documents it as a special case.
-  [
-    ApiResourceKind.project,
-    new Set<Verb>([
-      Verb.Apply,
-      Verb.Validate,
-      Verb.Get,
-      Verb.List,
-      Verb.Delete,
-    ]),
-  ],
   [ApiResourceKind.api_key, new Set<Verb>([Verb.Get, Verb.List, Verb.Delete])],
   // agent_execution is special — uses dedicated AgentExecutionQueryController
   // RPCs, not the unified SearchService. delete maps to cancel.

package/src/resources/apply/apply.integration.test.ts

@@ -268,12 +268,24 @@ describe("file-mode apply — channel app (#353)", () => {
   });
 });
 
-describe("file-mode apply — project special case", () => {
-  it("refuses a Project manifest with a pointer to the stigmer.yaml flow", () => {
+describe("file-mode apply — kinds the registry does not know", () => {
+  it("refuses a retired kind with what happened and what to run instead", () => {
     const dir = mkdtempSync(join(tmpdir(), "apply-it-"));
     try {
       writeYaml(dir, "project.yaml", ["kind: Project", "metadata:", "  name: Demo", "  slug: demo", ""].join("\n"));
-      expect(() => resolveApplyItems(dir)).toThrow(/stigmer\.yaml/);
+      expect(() => resolveApplyItems(dir)).toThrow(
+        /kind 'Project' in .*project\.yaml is no longer a Stigmer resource.*stigmer push plugin <dir>/,
+      );
+    } finally {
+      rmSync(dir, { recursive: true, force: true });
+    }
+  });
+
+  it("refuses a kind that never existed with the plain unknown-kind sentence", () => {
+    const dir = mkdtempSync(join(tmpdir(), "apply-it-"));
+    try {
+      writeYaml(dir, "thing.yaml", ["kind: Widget", "metadata:", "  name: Demo", ""].join("\n"));
+      expect(() => resolveApplyItems(dir)).toThrow(/^unknown resource kind 'Widget' in .*thing\.yaml$/);
     } finally {
       rmSync(dir, { recursive: true, force: true });
     }

package/src/resources/apply/apply.ts

@@ -18,7 +18,7 @@ import {
 } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
 import { UsageError } from "../../errors/index.js";
 import { CommandResult } from "../../output/index.js";
-import { defaultRegistry, Verb } from "../../registry/index.js";
+import { defaultRegistry, unknownKindError, Verb } from "../../registry/index.js";
 import { loadDocuments, resolveYamlFiles } from "../documents.js";
 import { decodeWorkflowTaskConfigs } from "../task-configs.js";
 import { type ApplyHandler, APPLY_HANDLERS, type ControllerFn } from "./handlers.js";
@@ -36,9 +36,9 @@ export interface ApplyOutcome {
   /** Optional org-mismatch warning to surface on stderr. */
   readonly warning?: string;
   /**
-   * The applied resource message (absent in dry-run). Carries the server's
-   * authoritative metadata (id/slug) — the reconciler reads this to register
-   * project membership, so membership matches what the backend stored.
+   * The applied resource message (absent in dry-run), as the server stored
+   * it: authoritative metadata (id, slug, visibility) for anything that
+   * runs after the apply.
    */
   readonly applied?: Message;
 }
@@ -60,22 +60,14 @@ export function resolveApplyItems(path: string): ApplyItem[] {
 
 /**
  * Resolve a YAML `kind` to its apply handler, enforcing the verb-support gate.
- * Shared by file mode and declarative mode so the lookup + error wording lives
- * in exactly one place. `where` is woven into errors for a precise location.
+ * The unknown-kind wording is the registry's (`unknownKindError`), shared
+ * with `validate -f`, so a retired kind is refused with the same sentence on
+ * both paths. `where` is woven into errors for a precise location.
  */
 export function resolveHandlerForKind(kind: string, where: string): ApplyHandler {
   const info = defaultRegistry().getByYamlKind(kind);
-  if (info === undefined) throw new UsageError(`unknown resource kind '${kind}' in ${where}`);
+  if (info === undefined) throw unknownKindError(kind, where);
   if (!info.supportedVerbs.has(Verb.Apply)) throw new UsageError(`${info.displayName} does not support 'apply'`);
-  if (info.kind === ApiResourceKind.project) {
-    // Project's Apply verb is the stigmer.yaml track, deliberately not a
-    // manifest handler: a file-mode apply would create a second, member-less
-    // way to apply a project, bypassing the membership reconciler.
-    throw new UsageError(
-      `a Project is not applied from a resource manifest (${where}): ` +
-        "run `stigmer apply` in the directory containing stigmer.yaml and the project is reconciled from its members",
-    );
-  }
   const handler = APPLY_HANDLERS.get(info.kind);
   if (handler === undefined) throw new UsageError(`apply not implemented for ${info.displayName}`);
   return handler;
@@ -109,16 +101,15 @@ export async function applyItem(
 
 /**
  * Strict YAML→proto marshal for one item, with a precise location in the error.
- * Split out from {@link applyItem} so the declarative reconciler can marshal
- * without immediately applying (it batches messages, then reconciles).
+ * Split out from {@link applyItem} so marshalling can be exercised and reused
+ * apart from the apply it feeds.
  */
 export function marshalItem(item: ApplyItem): Message {
   try {
     const message = fromJson(item.handler.schema, item.document, { ignoreUnknownFields: false });
     // Workflow task_config blocks live inside an open Struct the top-level
-    // decode cannot see into; decode them per kind so a dry-run (and the
-    // reconciler's marshal) rejects exactly what a real apply rejects
-    // (stigmer/stigmer#778).
+    // decode cannot see into; decode them per kind so a dry-run rejects
+    // exactly what a real apply rejects (stigmer/stigmer#778).
     if (item.handler.kind === ApiResourceKind.workflow) {
       decodeWorkflowTaskConfigs(message as Workflow);
     }
@@ -130,11 +121,9 @@ export function marshalItem(item: ApplyItem): Message {
 
 /**
  * Apply a fully-marshalled resource message: inject org, then dry-run preview or
- * drive the controller's `apply` RPC. This is the single apply core shared by
- * both tracks — the declarative/file track feeds messages marshalled from YAML
- * (`marshalItem`), the synthesis track feeds messages decoded from `.pb`
- * (`fromBinary`). One core means one place where org injection, create/update
- * detection, and result shaping live (DD-009 §6).
+ * drive the controller's `apply` RPC. The single apply core behind file mode,
+ * taking the message rather than the YAML so org injection, create/update
+ * detection and result shaping live in one place whatever produced the message.
  */
 export async function applyMessage(
   controller: ControllerFn,

package/src/resources/apply/handlers.ts

@@ -1,6 +1,6 @@
-// Apply-handler registry for `apply -f` (file mode) and the synthesis track.
+// Apply-handler registry for `apply -f` (file mode).
 //
-// The declarative manifest kinds come from the SDK's manifest registry
+// The manifest kinds come from the SDK's manifest registry
 // (`manifestKinds()` in @stigmer/sdk) — the one table binding a kind to its
 // proto schema, its raw command-controller `apply` RPC, and its dependency
 // apply order. The CLI consumes that table instead of keeping a copy: the

package/src/resources/delete.ts

@@ -82,7 +82,6 @@ export const DELETE_HANDLERS: ReadonlyMap<ApiResourceKind, DeleteFn> = new Map<
     ApiResourceKind.mcp_server,
     (c, id, force) => c.mcpServer.delete({ resourceId: id, force }),
   ],
-  [ApiResourceKind.project, (c, id) => c.project.delete(id)],
   [
     ApiResourceKind.environment,
     (c, id, force) => c.environment.delete({ resourceId: id, force }),

package/src/resources/get-bindings.ts

@@ -17,7 +17,6 @@ import { WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/a
 import { WorkflowInstanceSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/api_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
 import { ApiKeySchema } from "@stigmer/protos/ai/stigmer/iam/apikey/v1/api_pb";
-import { ProjectSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
 import type { Stigmer } from "@stigmer/sdk";
 import { UsageError } from "../errors/index.js";
 import type { ParsedReference } from "./reference.js";
@@ -64,10 +63,6 @@ export const GET_BINDINGS: ReadonlyMap<ApiResourceKind, Getter> = new Map([
     ApiResourceKind.mcp_server,
     refGetter(ApiResourceKind.mcp_server, McpServerSchema, (c) => c.mcpServer),
   ],
-  [
-    ApiResourceKind.project,
-    refGetter(ApiResourceKind.project, ProjectSchema, (c) => c.project),
-  ],
   [
     ApiResourceKind.environment,
     refGetter(

package/src/resources/list.ts

@@ -55,7 +55,6 @@ export const SEARCH_KINDS: ReadonlySet<ApiResourceKind> =
     ApiResourceKind.agent,
     ApiResourceKind.workflow,
     ApiResourceKind.mcp_server,
-    ApiResourceKind.project,
     ApiResourceKind.skill,
     ApiResourceKind.plugin,
     ApiResourceKind.environment,

package/src/resources/validate.test.ts

@@ -8,7 +8,6 @@ describe("schemaForValidate", () => {
     expect(schemaForValidate(ApiResourceKind.agent)).toBeDefined();
     expect(schemaForValidate(ApiResourceKind.workflow)).toBeDefined();
     expect(schemaForValidate(ApiResourceKind.mcp_server)).toBeDefined();
-    expect(schemaForValidate(ApiResourceKind.project)).toBeDefined();
   });
 
   it("returns undefined for non-file-based kinds", () => {

package/src/resources/validate.ts

@@ -10,7 +10,6 @@ import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb"
 import { McpServerSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
 import { type Workflow, WorkflowSchema } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/api_pb";
 import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { ProjectSchema } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
 import { decodeWorkflowTaskConfigs } from "./task-configs.js";
 
 // Exported for the verb/dispatch conformance suite (registry/registry.test.ts),
@@ -21,7 +20,6 @@ export const VALIDATE_SCHEMAS: ReadonlyMap<ApiResourceKind, DescMessage> = new M
   [ApiResourceKind.agent, AgentSchema],
   [ApiResourceKind.workflow, WorkflowSchema],
   [ApiResourceKind.mcp_server, McpServerSchema],
-  [ApiResourceKind.project, ProjectSchema],
 ]);
 
 export function schemaForValidate(kind: ApiResourceKind): DescMessage | undefined {

package/local/seedpack-retire.d.ts

@@ -1,63 +0,0 @@
-import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
-import { type Stigmer } from "@stigmer/sdk";
-/**
- * The seedpack Project's slug, as every release before this one wrote it
- * (the server derived it from `metadata.name` in the seedpack's manifest).
- * Pinned bytes of installs that predate this release.
- */
-export declare const SEEDPACK_PROJECT_SLUG = "stigmer-seedpack";
-/**
- * The marker older releases wrote in the data dir to skip an unchanged
- * seedpack. Nothing reads it any more; the retire removes it so a data dir
- * carries no trace of a mechanism that no longer exists.
- */
-export declare const SEEDPACK_MARKER_FILE = ".seedpack-bootstrapped";
-/** A member of the seedpack Project, addressed the way the Project stored it. */
-export interface SeedpackMember {
-    readonly kind: ApiResourceKind;
-    readonly org: string;
-    readonly slug: string;
-}
-export type MemberOutcome = {
-    readonly action: "removed";
-    readonly member: SeedpackMember;
-} | {
-    readonly action: "already-gone";
-    readonly member: SeedpackMember;
-} | {
-    readonly action: "adopted";
-    readonly member: SeedpackMember;
-    /** The plugin that now manages the row: its slug, or its id when the plugin row is gone. */
-    readonly byPlugin: string;
-} | {
-    readonly action: "kept-referenced";
-    readonly member: SeedpackMember;
-    /** The referrers, as "agent 'org/slug'". */
-    readonly by: readonly string[];
-} | {
-    readonly action: "kept-refused";
-    readonly member: SeedpackMember;
-    /** The server's sentence. */
-    readonly reason: string;
-};
-export type RetireResult = {
-    readonly present: false;
-} | {
-    readonly present: true;
-    readonly outcomes: readonly MemberOutcome[];
-    /** False when the Project row itself could not be deleted; the reason is reported. */
-    readonly projectRemoved: boolean;
-    readonly projectRefusal?: string;
-};
-export interface RetireOptions {
-    /** The local data dir holding the marker file. */
-    readonly markerDir: string;
-}
-/**
- * Retire the seedpack Project the system org may hold. Idempotent: no
- * Project, no work beyond one read and a stale marker's removal.
- */
-export declare function retireSeedpack(stigmer: Stigmer, options: RetireOptions): Promise<RetireResult>;
-/** The report `stigmer up` prints, one block on stderr through `say`. */
-export declare function renderRetireReport(result: RetireResult, say: (line: string) => void): void;
-//# sourceMappingURL=seedpack-retire.d.ts.map

package/local/seedpack-retire.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seedpack-retire.d.ts","sourceRoot":"","sources":["../../src/local/seedpack-retire.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AAEtH,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,cAAc,CAAC;AAOxD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAY7D,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACpE;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEN,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAC3B;IACE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEN,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAmCvB;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1B,IAAI,CAwDN"}