@stigmer/cli 3.0.8

package/resources/apply/apply.d.ts

@@ -0,0 +1,55 @@
+import { type JsonValue, type Message } from "@bufbuild/protobuf";
+import type { McpServer } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/api_pb";
+import { type ApiResourceMetadata } from "@stigmer/protos/ai/stigmer/commons/apiresource/metadata_pb";
+import { CommandResult } from "../../output/index.js";
+import { type ApplyHandler, type ControllerFn } from "./handlers.js";
+export interface ApplyItem {
+    readonly filePath: string;
+    readonly handler: ApplyHandler;
+    readonly document: JsonValue;
+}
+export interface ApplyOutcome {
+    readonly result: CommandResult;
+    /** Set for successfully applied MCP servers, to drive post-apply discovery. */
+    readonly appliedMcpServer?: McpServer;
+    /** 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.
+     */
+    readonly applied?: Message;
+}
+/** Expand a path into ordered, kind-resolved apply items (strict YAML parse). */
+export declare 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.
+ */
+export declare function resolveHandlerForKind(kind: string, where: string): ApplyHandler;
+/** Stable sort by dependency priority (Array.prototype.sort is stable in V8). */
+export declare function sortApplyItems(items: ApplyItem[]): ApplyItem[];
+/** True when any item needs org context (everything except Organization). */
+export declare function requiresOrgContext(items: readonly ApplyItem[]): boolean;
+/** Apply a single YAML item: strict-marshal to a proto, then apply the message. */
+export declare function applyItem(controller: ControllerFn, item: ApplyItem, org: string, dryRun: boolean): Promise<ApplyOutcome>;
+/**
+ * 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).
+ */
+export declare 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).
+ */
+export declare function applyMessage(controller: ControllerFn, handler: ApplyHandler, message: Message, org: string, dryRun: boolean): Promise<ApplyOutcome>;
+/** Read a resource message's metadata (id/name/slug/org), if present. */
+export declare function resourceMetadata(message: Message): ApiResourceMetadata | undefined;
+//# sourceMappingURL=apply.d.ts.map

package/resources/apply/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/resources/apply/apply.ts"],"names":[],"mappings":"AAQA,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wDAAwD,CAAC;AAExF,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4DAA4D,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAE,KAAK,YAAY,EAAkB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAErF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAiBD,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAY3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAO/E;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAG9D;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,OAAO,CAEvE;AAED,mFAAmF;AACnF,wBAAsB,SAAS,CAC7B,UAAU,EAAE,YAAY,EACxB,IAAI,EAAE,SAAS,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAEvB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAMpD;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAcvB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAElF"}

package/resources/apply/apply.js

@@ -0,0 +1,163 @@
+// File-mode apply orchestration (`apply -f <file|dir>`).
+//
+// Pipeline per document: strict YAML→proto marshal (S-strict) → inject the
+// resolved org when absent → dry-run preview OR drive the raw command
+// controller's `apply` RPC with the full proto → build a CommandResult. Items
+// across all files are sorted into dependency order before applying so parents
+// (org → mcp_server → agent → workflow → …) land before their dependents.
+import { create, fromJson } from "@bufbuild/protobuf";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { ApiResourceMetadataSchema, } 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 { loadDocuments, resolveYamlFiles } from "../documents.js";
+import { APPLY_HANDLERS } from "./handlers.js";
+// Dependency apply order (ascending priority); kinds absent get 99 (applied
+// last). Mirrors Go's applier.DefaultApplyOrder.
+const APPLY_ORDER = new Map([
+    [ApiResourceKind.organization, 0],
+    [ApiResourceKind.mcp_server, 1],
+    [ApiResourceKind.agent, 2],
+    [ApiResourceKind.workflow, 3],
+    [ApiResourceKind.environment, 4],
+    [ApiResourceKind.identity_provider, 5],
+    [ApiResourceKind.oauth_app, 6],
+    [ApiResourceKind.agent_instance, 7],
+    [ApiResourceKind.workflow_instance, 8],
+    [ApiResourceKind.session, 9],
+]);
+/** Expand a path into ordered, kind-resolved apply items (strict YAML parse). */
+export function resolveApplyItems(path) {
+    const files = resolveYamlFiles(path);
+    if (files.length === 0)
+        throw new UsageError("no YAML files found");
+    const items = [];
+    for (const file of files) {
+        for (const doc of loadDocuments(file, { strict: true })) {
+            items.push({ filePath: file, handler: resolveHandlerForKind(doc.kind, file), document: doc.document });
+        }
+    }
+    if (items.length === 0)
+        throw new UsageError("no valid resources found in files");
+    return sortApplyItems(items);
+}
+/**
+ * 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.
+ */
+export function resolveHandlerForKind(kind, where) {
+    const info = defaultRegistry().getByYamlKind(kind);
+    if (info === undefined)
+        throw new UsageError(`unknown resource kind '${kind}' in ${where}`);
+    if (!info.supportedVerbs.has(Verb.Apply))
+        throw new UsageError(`${info.displayName} does not support 'apply'`);
+    const handler = APPLY_HANDLERS.get(info.kind);
+    if (handler === undefined)
+        throw new UsageError(`apply not implemented for ${info.displayName}`);
+    return handler;
+}
+/** Stable sort by dependency priority (Array.prototype.sort is stable in V8). */
+export function sortApplyItems(items) {
+    items.sort((a, b) => priorityOf(a.handler.kind) - priorityOf(b.handler.kind));
+    return items;
+}
+/** True when any item needs org context (everything except Organization). */
+export function requiresOrgContext(items) {
+    return items.some((item) => item.handler.kind !== ApiResourceKind.organization);
+}
+/** Apply a single YAML item: strict-marshal to a proto, then apply the message. */
+export async function applyItem(controller, item, org, dryRun) {
+    return applyMessage(controller, item.handler, marshalItem(item), org, dryRun);
+}
+/**
+ * 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).
+ */
+export function marshalItem(item) {
+    try {
+        return fromJson(item.handler.schema, item.document, { ignoreUnknownFields: false });
+    }
+    catch (err) {
+        throw new UsageError(`invalid ${item.handler.displayName} in ${item.filePath}: ${err.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).
+ */
+export async function applyMessage(controller, handler, message, org, dryRun) {
+    const warning = injectOrg(message, org);
+    const created = (metaOf(message)?.id ?? "") === "";
+    if (dryRun) {
+        return { result: buildDryRunResult(handler, message), warning };
+    }
+    const applied = await handler.apply(controller, message);
+    const result = buildApplyResult(handler, applied, created);
+    if (handler.kind === ApiResourceKind.mcp_server) {
+        return { result, appliedMcpServer: applied, warning, applied };
+    }
+    return { result, warning, applied };
+}
+/** Read a resource message's metadata (id/name/slug/org), if present. */
+export function resourceMetadata(message) {
+    return metaOf(message);
+}
+function metaOf(message) {
+    return message.metadata;
+}
+// Inject the resolved org into metadata.org when the document omitted it. When
+// the document specifies a *different* org, return a warning (Go warns but
+// honors the document's value — we do the same).
+function injectOrg(message, org) {
+    if (org === "")
+        return undefined;
+    const holder = message;
+    if (holder.metadata === undefined) {
+        holder.metadata = create(ApiResourceMetadataSchema, { org });
+        return undefined;
+    }
+    if (holder.metadata.org === "") {
+        holder.metadata.org = org;
+        return undefined;
+    }
+    if (holder.metadata.org !== org) {
+        return `resource org '${holder.metadata.org}' differs from target org '${org}'; using '${holder.metadata.org}'`;
+    }
+    return undefined;
+}
+function buildApplyResult(handler, applied, created) {
+    const meta = metaOf(applied);
+    const result = CommandResult.success(`${handler.displayName} ${created ? "created" : "updated"} successfully`);
+    const section = result.addSection("Resource Details");
+    if (meta?.id)
+        section.field("ID", meta.id);
+    if (meta?.name)
+        section.field("Name", meta.name);
+    if (meta?.slug)
+        section.field("Slug", meta.slug);
+    return result;
+}
+function buildDryRunResult(handler, message) {
+    const meta = metaOf(message);
+    const name = meta?.name ?? handler.displayName;
+    const result = CommandResult.success(`Dry run: ${name} is valid`);
+    const section = result.addSection(`${handler.displayName} Preview`);
+    if (meta?.name)
+        section.field("Name", meta.name);
+    if (meta?.slug)
+        section.field("Slug", meta.slug);
+    if (meta?.org)
+        section.field("Org", meta.org);
+    return result;
+}
+function priorityOf(kind) {
+    return APPLY_ORDER.get(kind) ?? 99;
+}
+//# sourceMappingURL=apply.js.map

package/resources/apply/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/resources/apply/apply.ts"],"names":[],"mappings":"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"}

package/resources/apply/declarative.d.ts

@@ -0,0 +1,106 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type Project } from "@stigmer/protos/ai/stigmer/tenancy/project/v1/api_pb";
+import type { Stigmer } from "@stigmer/sdk";
+import { CommandResult } from "../../output/index.js";
+import { type PushResult } from "../skill.js";
+import { type ApplyItem } from "./apply.js";
+import type { ApplyHandler, ControllerFn } from "./handlers.js";
+/** The detected CLI operation mode (mirrors Go's project.Track). */
+export type Track = "atomic" | "declarative" | "project";
+export interface DetectResult {
+    readonly track: Track;
+    /** Absolute path to stigmer.yaml; undefined for the atomic track. */
+    readonly configPath?: string;
+    /** Directory containing stigmer.yaml; undefined for the atomic track. */
+    readonly configDir?: string;
+    /** Parsed Project; undefined for the atomic track. */
+    readonly project?: Project;
+}
+/**
+ * Walk up from `startDir` (max 10 levels, matching Go) looking for stigmer.yaml.
+ * Absent → atomic track. Present-but-invalid → a hard error (the user clearly
+ * intended a project; help them fix it rather than silently falling back).
+ * Present with an entry_point → the SDK "project" track (synthesis), which this
+ * wave does not implement.
+ */
+export declare function detectTrack(startDir: string, maxDepth?: number): DetectResult;
+/**
+ * YAML resource files beside stigmer.yaml: top-level files plus files in
+ * immediate subdirectories. stigmer.yaml itself is excluded, as are skill
+ * directories (handled separately) and grouping dirs that hold skills.
+ */
+export declare function scanResourceFiles(projectDir: string): string[];
+/**
+ * Skill directories beside stigmer.yaml: immediate children that contain a
+ * SKILL.md (flat layout), plus grandchildren under a grouping dir like skills/
+ * (organized layout). Scanning stops one level deep, matching Go.
+ */
+export declare function scanSkillDirectories(projectDir: string): string[];
+/**
+ * Build ordered apply items from scanned resource files. Project documents are
+ * skipped (stigmer.yaml is already loaded) and Organization documents are
+ * skipped with a warning — an organization sits above a project in the resource
+ * hierarchy and must be applied independently with file mode.
+ */
+export declare function buildDeclarativeItems(files: readonly string[], warn: (line: string) => void): ApplyItem[];
+export interface DeclarativeDeps {
+    /** Raw command-controller accessor (full-proto apply, preserves metadata.id). */
+    readonly controller: ControllerFn;
+    /** High-level client for skill push + post-apply MCP discovery. */
+    readonly stigmer: Stigmer;
+    /** Resolved organization (already validated non-empty by the caller). */
+    readonly org: string;
+    /** Human progress lines (stderr; not a parity surface). */
+    readonly info: (line: string) => void;
+    /** Warnings (stderr). */
+    readonly warn: (line: string) => void;
+}
+/**
+ * Apply a declarative project: scan the directory for YAML resources and skill
+ * directories, marshal each resource, then hand everything to the shared
+ * reconciler. This adapter's only job is "filesystem → resources + skill
+ * sources"; the synthesis track has its own adapter ("SDK → resources + skill
+ * sources") and both converge on {@link reconcileProjectMembers} (DD-009 §6).
+ */
+export declare function applyDeclarative(detect: DetectResult, deps: DeclarativeDeps): Promise<CommandResult>;
+/** A resource ready to apply: its handler plus the fully-marshalled message. */
+export interface ReconcileResource {
+    readonly handler: ApplyHandler;
+    readonly message: Message;
+}
+/**
+ * A skill to push as a project member. `local` is a directory beside the
+ * project (declarative) or resolved from a SkillSynth local path (synthesis);
+ * `git` is a remote repo cloned on demand (synthesis only — SkillSynth git).
+ */
+export type SkillSource = {
+    readonly kind: "local";
+    readonly dir: string;
+    readonly tag: string;
+} | {
+    readonly kind: "git";
+    readonly url: string;
+    readonly ref: string;
+    readonly subdir: string;
+    readonly tag: string;
+};
+/**
+ * Reconcile a project's membership: push skills first (agents may reference
+ * them), apply each resource through the shared apply core, collect references
+ * to the member-eligible ones, run post-apply MCP discovery, then apply the
+ * project with that exact member set so the server can reconcile by
+ * set-difference (orphan pruning is server-side; see S1 in commands/apply.ts).
+ */
+export declare function reconcileProjectMembers(project: Project, resources: readonly ReconcileResource[], skillSources: readonly SkillSource[], deps: DeclarativeDeps): Promise<CommandResult>;
+/**
+ * Push one skill source and return the result. Local sources push directly;
+ * git sources clone to a temp dir, push from the subdir, then clean up
+ * (mirrors `commands/push.ts` --git-url and Go's `pushSkillSynth`).
+ */
+export declare function pushSkillSource(client: Stigmer, src: SkillSource, org: string, info: (line: string) => void): Promise<PushResult>;
+/** Dry-run: validate every resource without touching the backend. */
+export declare function previewDeclarative(detect: DetectResult, deps: Pick<DeclarativeDeps, "controller" | "warn">): {
+    results: CommandResult[];
+    summary: CommandResult;
+};
+//# sourceMappingURL=declarative.d.ts.map

package/resources/apply/declarative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarative.d.ts","sourceRoot":"","sources":["../../../src/resources/apply/declarative.ts"],"names":[],"mappings":"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"}