@skrr-ai/cli 0.1.8

package/dist/commands/github/run.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+export default class GitHubRun extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        tool: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        input: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        args: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'request-id': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        provider: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        bare: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/github/run.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const agent_resolver_1 = require("../../lib/agent-resolver");
+const github_tools_1 = require("../../lib/github-tools");
+const integrations_helpers_1 = require("../../lib/integrations-helpers");
+const prompt_1 = require("../../lib/prompt");
+class GitHubRun extends base_command_1.BaseCommand {
+    static description = 'Run a GitHub integration tool for an agent';
+    static examples = [
+        '<%= config.bin %> github run create_issue --json -',
+        '<%= config.bin %> github run GITHUB_CREATE_ISSUE --args \'{"owner":"acme","repo":"app","title":"Bug","body":"Details"}\' --json',
+        '<%= config.bin %> github run list_pull_requests payload.json --agent <agent-id> --json',
+    ];
+    static args = {
+        tool: core_1.Args.string({
+            description: 'GitHub tool slug, e.g. create_issue or GITHUB_CREATE_ISSUE',
+            required: true,
+            ignoreStdin: true,
+        }),
+        input: core_1.Args.string({
+            description: 'Path to a JSON payload file, or "-" for stdin',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        ...base_command_1.BaseCommand.baseFlags,
+        args: core_1.Flags.string({
+            description: 'Inline JSON object payload. Values override file/stdin input.',
+        }),
+        agent: core_1.Flags.string({
+            description: 'Agent ID. Local daemon sessions prefer OVERSKY_SESSION_AGENT_ID and reject mismatches.',
+        }),
+        'request-id': core_1.Flags.string({
+            description: 'Idempotency key for side-effecting GitHub tools. Reuse to safely retry a run.',
+        }),
+        json: core_1.Flags.boolean({
+            description: 'Output full response as JSON',
+        }),
+        provider: core_1.Flags.string({
+            description: 'Integration provider. Defaults to OVERSKY_INTEGRATION_PROVIDER or the server default.',
+            default: undefined,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(GitHubRun);
+        let fileInput = {};
+        try {
+            fileInput = await (0, prompt_1.readJsonBody)(args.input);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        let inlineInput = {};
+        if (flags.args) {
+            try {
+                inlineInput = (0, integrations_helpers_1.parseArgsFlag)(flags.args);
+            }
+            catch (err) {
+                this.error(`--args is not valid JSON: ${err.message}`, { exit: 1 });
+            }
+        }
+        let agentId;
+        try {
+            agentId = await (0, agent_resolver_1.resolveAgentId)(flags.agent);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 2 });
+        }
+        let toolSlug;
+        try {
+            toolSlug = (0, github_tools_1.normalizeGitHubToolSlug)(args.tool);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        const provider = (0, github_tools_1.resolveIntegrationProvider)(flags.provider);
+        const toolArguments = (0, prompt_1.mergeDefined)(fileInput, inlineInput);
+        let resp;
+        try {
+            resp = await data_provider_1.dataService.integrationsExecute(agentId, {
+                toolSlug,
+                arguments: toolArguments,
+                ...(flags['request-id'] ? { requestId: flags['request-id'] } : {}),
+                ...(provider ? { provider } : {}),
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(resp, null, 2));
+            return;
+        }
+        const cached = resp.cached ? ' (cached)' : '';
+        this.log(`GitHub tool ${toolSlug} executed in ${resp.durationMs}ms${cached}`);
+        this.log(typeof resp.result === 'string' ? resp.result : JSON.stringify(resp.result, null, 2));
+    }
+}
+exports.default = GitHubRun;

package/dist/commands/github/tools.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command';
+export default class GitHubTools extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        query: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cached: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        provider: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        bare: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/github/tools.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const agent_resolver_1 = require("../../lib/agent-resolver");
+const github_tools_1 = require("../../lib/github-tools");
+class GitHubTools extends base_command_1.BaseCommand {
+    static description = 'List or search GitHub tools available to an agent';
+    static examples = [
+        '<%= config.bin %> github tools',
+        '<%= config.bin %> github tools "create issue" --json',
+        '<%= config.bin %> github tools --cached --agent <agent-id>',
+    ];
+    static args = {
+        query: core_1.Args.string({
+            description: 'Optional search query, e.g. "create issue" or "pull requests"',
+            required: false,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        ...base_command_1.BaseCommand.baseFlags,
+        agent: core_1.Flags.string({
+            description: 'Agent ID. Local daemon sessions prefer OVERSKY_SESSION_AGENT_ID and reject mismatches.',
+        }),
+        cached: core_1.Flags.boolean({
+            description: 'Return cached tool list when not searching',
+            default: false,
+        }),
+        limit: core_1.Flags.integer({
+            description: 'Maximum search results',
+            default: 20,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output tools as JSON' }),
+        provider: core_1.Flags.string({
+            description: 'Integration provider. Defaults to OVERSKY_INTEGRATION_PROVIDER or the server default.',
+            default: undefined,
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(GitHubTools);
+        let agentId;
+        try {
+            agentId = await (0, agent_resolver_1.resolveAgentId)(flags.agent);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 2 });
+        }
+        const provider = (0, github_tools_1.resolveIntegrationProvider)(flags.provider);
+        let tools;
+        try {
+            if (args.query) {
+                const resp = await data_provider_1.dataService.integrationsSearchTools(agentId, args.query, flags.limit, provider);
+                tools = (0, github_tools_1.filterGitHubTools)(resp.tools || []);
+            }
+            else {
+                const resp = await data_provider_1.dataService.integrationsListTools(agentId, flags.cached, provider);
+                tools = (0, github_tools_1.filterGitHubTools)(resp.tools || []);
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ tools: tools }, null, 2));
+            return;
+        }
+        if (tools.length === 0) {
+            this.log('No GitHub tools available. Connect GitHub first with `skrr github connect` and allow tools for this agent.');
+            return;
+        }
+        this.log(`${tools.length} GitHub tool(s) available:\n`);
+        for (const tool of tools) {
+            this.log(`  ${tool.name}`);
+            this.log(`    ${tool.description}`);
+            this.log('');
+        }
+    }
+}
+exports.default = GitHubTools;

package/dist/commands/goals/archive.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command';
+export default class GoalsArchive extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        unarchive: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/archive.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const web_url_1 = require("../../lib/web-url");
+class GoalsArchive extends base_command_1.BaseCommand {
+    static description = 'Archive a goal (reversible — use --unarchive to restore)';
+    static examples = [
+        '<%= config.bin %> goals archive <goal-id>',
+        '<%= config.bin %> goals archive <goal-id> --unarchive',
+        '<%= config.bin %> goals archive <goal-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Goal ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        unarchive: core_1.Flags.boolean({ description: 'Unarchive the goal instead of archiving it' }),
+        json: core_1.Flags.boolean({ description: 'Output the updated goal as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(GoalsArchive);
+        let result;
+        try {
+            result = flags.unarchive
+                ? await data_provider_1.dataService.unarchiveGoal(args.id)
+                : await data_provider_1.dataService.archiveGoal(args.id);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify((0, web_url_1.withGoalUrl)(this.cliConfig.baseURL, result), null, 2));
+            return;
+        }
+        const action = flags.unarchive ? 'unarchived' : 'archived';
+        this.log(`Goal ${args.id} ${action}`);
+    }
+}
+exports.default = GoalsArchive;

package/dist/commands/goals/briefing/disable.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../../base-command';
+export default class GoalsBriefingDisable extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/briefing/disable.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+class GoalsBriefingDisable extends base_command_1.BaseCommand {
+    static description = 'Disable the daily morning goal briefing';
+    static examples = [
+        '<%= config.bin %> goals briefing disable',
+        '<%= config.bin %> goals briefing disable --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the result as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(GoalsBriefingDisable);
+        let result;
+        try {
+            result = await data_provider_1.dataService.disableGoalBriefing();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log('Morning briefing disabled');
+    }
+}
+exports.default = GoalsBriefingDisable;

package/dist/commands/goals/briefing/enable.d.ts

@@ -0,0 +1,10 @@
+import { BaseCommand } from '../../../base-command';
+export default class GoalsBriefingEnable extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        cron: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/briefing/enable.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+class GoalsBriefingEnable extends base_command_1.BaseCommand {
+    static description = 'Enable the daily morning goal briefing';
+    static examples = [
+        '<%= config.bin %> goals briefing enable',
+        '<%= config.bin %> goals briefing enable --cron "0 7 * * *"',
+        '<%= config.bin %> goals briefing enable --json',
+    ];
+    static flags = {
+        cron: core_1.Flags.string({ description: 'Cron schedule for the briefing (e.g. "0 8 * * *")' }),
+        json: core_1.Flags.boolean({ description: 'Output the result as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(GoalsBriefingEnable);
+        let result;
+        try {
+            result = await data_provider_1.dataService.enableGoalBriefing(flags.cron);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const cron = flags.cron ?? '0 8 * * *';
+        this.log(`Morning briefing enabled (cron: ${cron})`);
+    }
+}
+exports.default = GoalsBriefingEnable;

package/dist/commands/goals/briefing/preview.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../../base-command';
+export default class GoalsBriefingPreview extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/briefing/preview.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+class GoalsBriefingPreview extends base_command_1.BaseCommand {
+    static description = 'Preview the daily morning goal briefing';
+    static examples = [
+        '<%= config.bin %> goals briefing preview',
+        '<%= config.bin %> goals briefing preview --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(GoalsBriefingPreview);
+        let result;
+        try {
+            result = await data_provider_1.dataService.previewGoalBriefing();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const b = result;
+        const body = b?.summary ?? b?.content ?? b?.text;
+        if (typeof body === 'string') {
+            this.log(body);
+        }
+        else {
+            this.log('Briefing (use --json for full payload):');
+            this.log(JSON.stringify(result, null, 2));
+        }
+    }
+}
+exports.default = GoalsBriefingPreview;

package/dist/commands/goals/create.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command';
+export default class GoalsCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        title: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        level: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'target-date': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        project: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        parent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'owner-agent': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dri-agent': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dri-user': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/create.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const web_url_1 = require("../../lib/web-url");
+const prompt_1 = require("../../lib/prompt");
+const projects_1 = require("../../lib/projects");
+class GoalsCreate extends base_command_1.BaseCommand {
+    static description = 'Create a new goal';
+    static examples = [
+        '<%= config.bin %> goals create --title "Ship Q2 roadmap" --level company',
+        '<%= config.bin %> goals create --title "Launch checklist" --space <space-id>',
+        '<%= config.bin %> goals create --title "Feature launch" --level team --parent <parent-id>',
+        '<%= config.bin %> goals create --title "Research" --level task --dri-agent <agent-id>',
+        '<%= config.bin %> goals create --title "Beta ready" --project <project-id> --target-date 2026-10-01',
+        '<%= config.bin %> goals create --from-json goal.json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the created goal as JSON' }),
+        'from-json': core_1.Flags.string({
+            description: 'Path to a JSON file (or "-" for stdin) to use as the request body',
+        }),
+        title: core_1.Flags.string({ description: 'Goal title (required unless set via --from-json)' }),
+        description: core_1.Flags.string({ description: 'Goal description' }),
+        level: core_1.Flags.string({
+            description: 'Goal level',
+            options: ['company', 'team', 'agent', 'task'],
+        }),
+        'target-date': core_1.Flags.string({ description: 'Target date (YYYY-MM-DD or ISO timestamp)' }),
+        space: core_1.Flags.string({ description: 'Space ID to link this goal into after creation' }),
+        project: core_1.Flags.string({
+            description: 'Project to contain this goal — id, or a ref (OSK-P-12) alongside --space, or a qualified ref (OSK-S-3/OSK-P-12)',
+        }),
+        parent: core_1.Flags.string({ description: 'Parent goal ID' }),
+        'owner-agent': core_1.Flags.string({ description: 'Owner agent ID' }),
+        // DRI is mutually exclusive: the server at routes/goals.js silently
+        // prefers the agent DRI when both are passed, which can cause silent
+        // data loss. Enforce the exclusion locally so oclif rejects it before
+        // the request is sent.
+        'dri-agent': core_1.Flags.string({
+            description: 'DRI (directly responsible) agent ID',
+            exclusive: ['dri-user'],
+        }),
+        'dri-user': core_1.Flags.string({
+            description: 'DRI user ID',
+            exclusive: ['dri-agent'],
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(GoalsCreate);
+        // Default to {} so TS flow-analysis is satisfied — the catch calls this.error(), which throws.
+        let body = {};
+        try {
+            body = await (0, prompt_1.readJsonBody)(flags['from-json']);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        // `--space` names the space this goal belongs in, and the create body has
+        // to carry it.
+        //
+        // It used to be withheld on the reasoning that `--space` meant "link AFTER
+        // creation", with only a project REF forcing it into the body because refs
+        // are space-scoped. That made the link a second, unrelated call — and the
+        // goal was born with no workspace, because the server infers a goal's
+        // workspace from its PARENTS (`homeWorkspacePatch`, routes/goals.js:
+        // "inherit from the parent the caller was authorized against"), and
+        // `spaceId` is the parent it reads. The link endpoint then compared a
+        // workspace-less goal against a workspaced space, found them unequal, and
+        // refused with 404 "Goal not found" — for a goal it had just created. It
+        // left the orphan behind, so every attempt added another.
+        //
+        // `--project <ref>` never hit this: it already sent `spaceId`, so its goals
+        // inherited the workspace and linked cleanly. The bug was the path that
+        // sent LESS information, not the one that sent more.
+        const { projectRef, spaceRef } = flags.project
+            ? (0, projects_1.splitQualifiedProjectRef)(flags.project, flags.space)
+            : { projectRef: undefined, spaceRef: undefined };
+        const projectRefNeedsSpace = Boolean(projectRef && projects_1.PROJECT_REF_PATTERN.test(projectRef));
+        // A qualified `OSK-S-3/OSK-P-12` carries its own space; otherwise `--space`.
+        const createSpaceRef = spaceRef ?? flags.space;
+        const payload = (0, prompt_1.mergeDefined)(body, {
+            title: flags.title,
+            description: flags.description,
+            level: flags.level,
+            targetDate: flags['target-date'],
+            parentId: flags.parent,
+            ownerAgentId: flags['owner-agent'],
+            driAgentId: flags['dri-agent'],
+            driUserId: flags['dri-user'],
+            projectId: projectRef,
+            ...(createSpaceRef ? { spaceId: await this.resolveSpaceReference(createSpaceRef) } : {}),
+        });
+        if (projectRefNeedsSpace && !spaceRef) {
+            this.error('A project ref is space-scoped. Pass --space, use the qualified ref `<space>/<project>`, or give the project id.', { exit: 2 });
+        }
+        if (!payload.title || typeof payload.title !== 'string') {
+            this.error('A title is required. Pass --title "..." or include it in --from-json.', {
+                exit: 1,
+            });
+        }
+        let created;
+        try {
+            created = await data_provider_1.dataService.createGoal(payload);
+            if (flags.space) {
+                const goalId = created.id;
+                if (!goalId || typeof goalId !== 'string') {
+                    this.error('Goal was created, but the response did not include an id to link.', {
+                        exit: 1,
+                    });
+                }
+                // Link via the dedicated atomic endpoint. A PATCH /api/spaces/:id that
+                // carries `goalIds` is rejected with `space_relations_atomic_only` — the
+                // server deliberately routes goal links through this $addToSet endpoint so
+                // concurrent edits can't clobber each other (same contract as `spaces
+                // labels add`). Re-linking an already-linked goal is a no-op.
+                await data_provider_1.dataService.linkGoalToSpace({ spaceId: flags.space, goalId });
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const g = created;
+        // The space link is applied after create, so the returned goal may not yet
+        // carry spaceId — fall back to the requested --space for the canonical URL.
+        const url = (0, web_url_1.goalUrlFrom)(this.cliConfig.baseURL, { ...g, spaceId: g.spaceId ?? flags.space });
+        if (flags.json) {
+            this.log(JSON.stringify({ ...g, url }, null, 2));
+            return;
+        }
+        const spaceNote = flags.space ? ` in space ${flags.space}` : '';
+        this.log(`Created goal ${g.id ?? g._id ?? '?'}${spaceNote} - ${g.title ?? '(no title)'}`);
+        if (url)
+            this.log(`View it at ${url}`);
+    }
+}
+exports.default = GoalsCreate;

package/dist/commands/goals/delete.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export default class GoalsDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/goals/delete.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const prompt_1 = require("../../lib/prompt");
+class GoalsDelete extends base_command_1.BaseCommand {
+    static description = 'Delete a goal (irreversible)';
+    static examples = [
+        '<%= config.bin %> goals delete <goal-id>',
+        '<%= config.bin %> goals delete <goal-id> --yes',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Goal ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        yes: core_1.Flags.boolean({ char: 'y', description: 'Skip confirmation prompt' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(GoalsDelete);
+        let confirmed;
+        try {
+            confirmed = await (0, prompt_1.confirmDestructive)(`Delete goal ${args.id}? This cannot be undone.`, flags.yes);
+        }
+        catch (err) {
+            if (err.exit === 7) {
+                this.error(err.message, { exit: 7 });
+            }
+            throw err;
+        }
+        if (!confirmed) {
+            this.log('Cancelled.');
+            return;
+        }
+        try {
+            await data_provider_1.dataService.deleteGoal(args.id);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        this.log(`Deleted goal ${args.id}`);
+    }
+}
+exports.default = GoalsDelete;