@vectorplane/ctrl-cli 0.1.9 → 0.1.10

package/README.md

@@ -17,6 +17,8 @@ vp login
 vp logout
 vp status
 vp sync
+vp context --workspace <workspace> --delivery
+vp session check-in --workspace <workspace> --agent codex --type codex --client openai-codex --feature feature-key --task task-key --owning-path "src/core,src/ui" --need "api-contract" --provide "implementation" --status "starting implementation"
 vp draft create --type progress --title "Entrega concluída" --content "Resumo da mudança"
 ```
 
@@ -53,6 +55,12 @@ vp draft create --type progress --title "Entrega concluída" --content "Resumo d
 - suporta `ui`, `ux`, `project_skeleton`, `template_engineering`, `patterns`, `progress`, `decisions` e `architecture`
 - aceita `--no-impact` para registrar explicitamente quando uma lane não foi afetada
 
+### `vp session`
+
+- suporta `check-in`, `heartbeat` e `check-out`
+- permite declarar `feature`, `task`, `component`, `role`, `owning-path`, `need`, `provide` e `status`
+- deve ser usado em conjunto com `vp context --delivery` para reduzir conflito entre agentes ativos
+
 ### Comandos adicionais já implementados
 
 - `vp whoami`

package/dist/commands/session.js

@@ -1,4 +1,4 @@
-import { getStringOption, parseArgs } from "../core/cli.js";
+import { getStringListOption, getStringOption, parseArgs } from "../core/cli.js";
 import { ensureSessionAvailable, getProfileState, updateProfileState } from "../core/config.js";
 import { collectGitContext } from "../core/git.js";
 import { collectMachineContext, collectRuntimeContext } from "../core/machine.js";
@@ -7,6 +7,25 @@ import { ensureFreshSession, resolveWorkspaceSlug } from "../core/session.js";
 import { VectorPlaneApiClient } from "../core/api.js";
 import { deriveClientInstanceId, getBoundWorkspace, resolveWorkspaceRoot } from "../core/workspace-binding.js";
 import { ValidationError } from "../core/errors.js";
+function readCollaborationMetadata(parsed, rootPath) {
+    const owningPaths = getStringListOption(parsed, "owning-path");
+    const needs = getStringListOption(parsed, "need");
+    const provides = getStringListOption(parsed, "provide");
+    const relatedWorkspaceIds = getStringListOption(parsed, "related-workspace");
+    return {
+        source: "vp-cli",
+        rootPath,
+        featureKey: getStringOption(parsed, "feature"),
+        taskKey: getStringOption(parsed, "task"),
+        component: getStringOption(parsed, "component"),
+        role: getStringOption(parsed, "role"),
+        statusSummary: getStringOption(parsed, "status"),
+        owningPaths: owningPaths.length > 0 ? owningPaths : undefined,
+        needs: needs.length > 0 ? needs : undefined,
+        provides: provides.length > 0 ? provides : undefined,
+        relatedWorkspaceIds: relatedWorkspaceIds.length > 0 ? relatedWorkspaceIds : undefined,
+    };
+}
 export async function runSessionCommand(cliVersion, args) {
     const parsed = parseArgs(args);
     const [subcommand] = parsed.positionals;
@@ -38,6 +57,7 @@ export async function runSessionCommand(cliVersion, args) {
         throw new ValidationError("Nenhum workspace resolvido para a sessão.");
     }
     const clientInstanceId = getStringOption(parsed, "client-instance-id") ?? deriveClientInstanceId(runtime.device.machineId, rootPath, git);
+    const metadata = readCollaborationMetadata(parsed, rootPath);
     if (subcommand === "check-in") {
         const response = await apiClient.checkInAgent(freshSession.accessToken, {
             workspaceId: workspace,
@@ -48,10 +68,7 @@ export async function runSessionCommand(cliVersion, args) {
             repoUrl: git.remoteOrigin ?? undefined,
             branch: git.branch,
             commitSha: git.commitHash,
-            metadata: {
-                source: "vp-cli",
-                rootPath,
-            },
+            metadata,
         });
         const sessionId = String(response.id ?? response.sessionId ?? "");
         await updateProfileState(runtime.profile.name, {
@@ -62,6 +79,12 @@ export async function runSessionCommand(cliVersion, args) {
         });
         process.stdout.write(`Session ID: ${sessionId || "não retornado"}\n`);
         process.stdout.write(`Client Instance ID: ${clientInstanceId}\n`);
+        if (metadata.featureKey) {
+            process.stdout.write(`Feature: ${metadata.featureKey}\n`);
+        }
+        if (metadata.taskKey) {
+            process.stdout.write(`Task: ${metadata.taskKey}\n`);
+        }
         return 0;
     }
     if (subcommand === "heartbeat") {
@@ -74,16 +97,16 @@ export async function runSessionCommand(cliVersion, args) {
             clientInstanceId,
             branch: git.branch,
             commitSha: git.commitHash,
-            metadata: {
-                source: "vp-cli",
-                rootPath,
-            },
+            metadata,
         });
         await updateProfileState(runtime.profile.name, {
             lastCommand: "session:heartbeat",
             lastError: null,
         });
         process.stdout.write(`Heartbeat enviado para ${sessionId}\n`);
+        if (metadata.statusSummary) {
+            process.stdout.write(`Status: ${metadata.statusSummary}\n`);
+        }
         return 0;
     }
     if (subcommand === "check-out") {
@@ -95,6 +118,9 @@ export async function runSessionCommand(cliVersion, args) {
             sessionId,
             metadata: {
                 source: "vp-cli",
+                featureKey: metadata.featureKey,
+                taskKey: metadata.taskKey,
+                statusSummary: metadata.statusSummary,
             },
         });
         await updateProfileState(runtime.profile.name, {

package/dist/core/cli.d.ts

@@ -5,5 +5,6 @@ export interface ParsedArgs {
 export declare function parseArgs(args: string[]): ParsedArgs;
 export declare function getStringOption(parsed: ParsedArgs, key: string): string | undefined;
 export declare function getBooleanOption(parsed: ParsedArgs, key: string): boolean;
+export declare function getStringListOption(parsed: ParsedArgs, key: string): string[];
 export declare function requirePositional(parsed: ParsedArgs, index: number, message: string): string;
 export declare function parseJsonOption(value: string | undefined, fallback?: Record<string, unknown>): Record<string, unknown>;

package/dist/core/cli.js

@@ -38,6 +38,16 @@ export function getBooleanOption(parsed, key) {
     }
     return false;
 }
+export function getStringListOption(parsed, key) {
+    const value = getStringOption(parsed, key);
+    if (!value) {
+        return [];
+    }
+    return [...new Set(value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean))];
+}
 export function requirePositional(parsed, index, message) {
     const value = parsed.positionals[index];
     if (!value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectorplane/ctrl-cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "Official VectorPlane CLI.",
   "type": "module",
   "main": "./dist/index.js",