nextclaw 0.48.0-beta.1 → 0.48.0-beta.2

package/dist/cli/app/index.js

@@ -5,7 +5,7 @@ import { NextclawDistributionService } from "@nextclaw/service";
 const distribution = createNextclawDistribution(import.meta.url);
 repairPackagedPortableRunnerPermissions(distribution);
 NextclawDistributionService.configureRuntime(distribution);
-const { nextclawCliProgram } = await import("../../nextclaw-cli-app-cRvTVj04.js");
+const { nextclawCliProgram } = await import("../../nextclaw-cli-app-FS6IsYq6.js");
 await nextclawCliProgram.parseAsync(process.argv);
 //#endregion
 export {};

package/dist/{nextclaw-cli-app-cRvTVj04.js → nextclaw-cli-app-FS6IsYq6.js}

@@ -5399,6 +5399,17 @@ var AppPackageLiveService = class {
 	}
 	list = async () => await this.requireApiClient().request({ path: "/api/app-packages" });
 	info = async (appId) => await this.requireApiClient().request({ path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}` });
+	inspectDocumentAccess = async (appId) => await this.requireApiClient().request({ path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/document-access` });
+	grantDocumentAccess = async (appId, input) => await this.requireApiClient().request({
+		path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/document-access/grant`,
+		method: "POST",
+		body: input
+	});
+	revokeDocumentAccess = async (appId, scopeId) => await this.requireApiClient().request({
+		path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/document-access/revoke`,
+		method: "POST",
+		body: { scopeId: this.requireValue(scopeId, "Document scope") }
+	});
 	listOperations = async () => await this.requireApiClient().request({ path: "/api/app-package-operations" });
 	inspectDependencies = async (appId) => await this.requireApiClient().request({ path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/dependencies` });
 	verifyDependencies = async (appId) => await this.requireApiClient().request({ path: `/api/app-packages/${encodeURIComponent(this.requireId(appId))}/dependencies/verify` });
@@ -5551,6 +5562,19 @@ var AppPackageCommandController = class {
 	marketplaceInfo = async (selector, options) => this.write(await this.marketplaceService.info(selector), options, this.formatMarketplaceInfo);
 	list = async (options) => this.write(await this.liveService.list(), options, this.formatList);
 	info = async (appId, options) => this.write(await this.liveService.info(appId), options, this.formatApp);
+	inspectDocumentAccess = async (appId, options) => this.write(await this.liveService.inspectDocumentAccess(appId), options, this.formatDocumentAccess);
+	grantDocumentAccess = async (appId, options) => {
+		await this.liveService.grantDocumentAccess(appId, {
+			scopeId: options.scope,
+			directoryPath: options.path,
+			mode: options.mode
+		});
+		this.write(await this.liveService.inspectDocumentAccess(appId), options, this.formatDocumentAccess);
+	};
+	revokeDocumentAccess = async (appId, options) => {
+		await this.liveService.revokeDocumentAccess(appId, options.scope);
+		this.write(await this.liveService.inspectDocumentAccess(appId), options, this.formatDocumentAccess);
+	};
 	inspectDependencies = async (appId, options) => this.write(await this.liveService.inspectDependencies(appId), options, this.formatDependencyView);
 	verifyDependencies = async (appId, options) => this.write(await this.liveService.verifyDependencies(appId), options, this.formatDependencyView);
 	setupDependencies = async (appId, options) => this.write(await this.liveService.setupDependencies(appId), options, this.formatDependencyView);
@@ -5714,6 +5738,13 @@ var AppPackageCommandController = class {
 		...result.bindings.map((binding) => `  binding: ${binding.componentId}/${binding.requirementKind}/${binding.requirementId} -> ${binding.providerId}`)
 	].join("\n") + "\n";
 	formatSecretReadiness = (result) => [`Secret readiness: ${result.readiness.status}`, ...result.slots.map((slot) => `  slot: ${slot.id} ${slot.status}${slot.binding ? ` (${slot.binding.source}/${slot.binding.provider ?? slot.binding.source}/${slot.binding.id})` : ""}${slot.errorCode ? ` [${slot.errorCode}]` : ""}`)].join("\n") + "\n";
+	formatDocumentAccess = (result) => [`Document access for ${result.name} (${result.appId})`, ...result.documentAccess.map((scope) => [
+		`  ${scope.id}: ${scope.status}`,
+		`    declared: ${scope.mode}`,
+		`    granted: ${scope.effectiveMode ?? "-"}`,
+		`    resource: ${scope.grantedPath ?? "-"}`,
+		scope.description ? `    purpose: ${scope.description}` : ""
+	].filter(Boolean).join("\n"))].join("\n") + "\n";
 	formatOperation = (operation) => [
 		`App operation ${operation.id}`,
 		`  action: ${operation.action}`,
@@ -5836,6 +5867,7 @@ function registerAppPackageCommands(app, appPackages) {
 	app.command("info <app-id>").description("Show an App installed in the running NextClaw host").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.info(appId, opts));
 	registerAppDependencyCommands(app, appPackages);
 	registerAppSecretCommands(app, appPackages);
+	registerAppPermissionCommands(app, appPackages);
 	registerPortableRuntimeAppCommands(app, appPackages);
 	app.command("operations").description("List App install, update, rollback, and uninstall operations").option("--json", "Output JSON", false).action(async (opts) => appPackages.operations(opts));
 	app.command("install <source>").description("Install an App through the running NextClaw host").option("--registry <url>", "Registry URL for an App id").option("--json", "Output JSON", false).action(async (source, opts) => appPackages.install(source, opts));
@@ -5846,6 +5878,13 @@ function registerAppPackageCommands(app, appPackages) {
 	app.command("rollback <app-id>").description("Roll back an App to an installed version").requiredOption("--version <version>", "Installed version to activate").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.rollback(appId, opts));
 	app.command("uninstall <app-id>").description("Uninstall an App through the running NextClaw host").option("--purge-data", "Permanently delete App data", false).option("--confirm <app-id>", "Confirm the exact App id when purging data").option("--json", "Output JSON", false).action(async (appId, opts) => appPackages.uninstall(appId, opts));
 }
+function registerAppPermissionCommands(app, controller) {
+	const permissions = app.command("permissions").description("Inspect and manage an App's user-approved permissions");
+	permissions.command("inspect <app-id>").description("Show declared document scopes and current grants").option("--json", "Output JSON", false).action(async (appId, opts) => controller.inspectDocumentAccess(appId, opts));
+	const document = permissions.command("document").description("Grant or revoke access to a runtime-host directory");
+	document.command("grant <app-id>").description("Grant or replace one declared document scope").requiredOption("--scope <id>", "Declared document scope id").requiredOption("--path <path>", "Directory path on the runtime host").requiredOption("--mode <mode>", "Effective mode: read or read-write").option("--json", "Output JSON", false).action(async (appId, opts) => controller.grantDocumentAccess(appId, opts));
+	document.command("revoke <app-id>").description("Revoke one declared document scope").requiredOption("--scope <id>", "Declared document scope id").option("--json", "Output JSON", false).action(async (appId, opts) => controller.revokeDocumentAccess(appId, opts));
+}
 function registerAppSecretCommands(app, controller) {
 	const secrets = app.command("secrets").description("Inspect and manage non-sensitive SecretRef bindings for an App");
 	secrets.command("inspect <app-id>").description("Show declared Secret slots and non-sensitive bindings").option("--json", "Output JSON", false).action(async (appId, opts) => controller.inspectSecrets(appId, opts));
@@ -5881,6 +5920,25 @@ function registerProjectCommands(program, nextclaw) {
 	projects.command("templates").description("List built-in project templates").option("--json", "Output JSON", false).action((options) => commands.templates(options));
 	projects.command("observe <root-path>").description("Observe a registered project without changing project data").option("--json", "Output JSON", false).action((rootPath, options) => commands.observe(rootPath, options));
 	projects.command("create <name>").description("Create and register a project").option("--path <directory>", "Target directory").option("--template <template>", "Project template: empty or knowledge-base", "empty").option("--json", "Output JSON", false).action((name, options) => commands.create(name, options));
+	registerProjectWorkCommands(projects, commands);
+}
+function registerProjectWorkCommands(projects, commands) {
+	const work = projects.command("work").description("Manage persistent project work items");
+	work.command("list").description("List work items").requiredOption("--project <id>", "Project id").option("--include-deleted", "Include deleted work items", false).option("--json", "Output JSON", false).action((options) => commands.workList(options));
+	work.command("get <work-item-id>").description("Show a work item").requiredOption("--project <id>", "Project id").option("--json", "Output JSON", false).action((workItemId, options) => commands.workGet(workItemId, options));
+	work.command("create <title>").description("Create a work item").requiredOption("--project <id>", "Project id").option("--description <text>", "Description").option("--state <id>", "Initial state id").option("--attention <value>", "Attention: none, blocked, or awaiting-user").option("--json", "Output JSON", false).action((title, options) => commands.workCreate(title, options));
+	work.command("update <work-item-id>").description("Update fields or move a work item").requiredOption("--project <id>", "Project id").option("--title <text>", "New title").option("--description <text>", "New description").option("--state <id>", "New state id").option("--attention <value>", "Attention: none, blocked, or awaiting-user").option("--version <number>", "Expected version").option("--json", "Output JSON", false).action((workItemId, options) => commands.workUpdate(workItemId, options));
+	work.command("delete <work-item-id>").description("Soft-delete a work item").requiredOption("--project <id>", "Project id").option("--json", "Output JSON", false).action((workItemId, options) => commands.workDelete(workItemId, options));
+	work.command("restore <work-item-id>").description("Restore a deleted work item").requiredOption("--project <id>", "Project id").option("--json", "Output JSON", false).action((workItemId, options) => commands.workRestore(workItemId, options));
+	work.command("activity <work-item-id>").description("Show immutable work item activity").requiredOption("--project <id>", "Project id").option("--limit <number>", "Maximum entries", "50").option("--json", "Output JSON", false).action((workItemId, options) => commands.workActivity(workItemId, options));
+	const artifact = work.command("artifact").description("Manage work item artifact links");
+	artifact.command("link <work-item-id> <path>").description("Link a project file to a work item").requiredOption("--project <id>", "Project id").option("--label <text>", "Display label").option("--json", "Output JSON", false).action((workItemId, path, options) => commands.workArtifactLink(workItemId, path, options));
+	artifact.command("unlink <work-item-id> <artifact-link-id>").description("Remove a work item artifact link").requiredOption("--project <id>", "Project id").option("--json", "Output JSON", false).action((workItemId, artifactLinkId, options) => commands.workArtifactUnlink(workItemId, artifactLinkId, options));
+	const states = work.command("state").description("Manage project work states");
+	states.command("list").description("List project work states").requiredOption("--project <id>", "Project id").option("--json", "Output JSON", false).action((options) => commands.workStateList(options));
+	states.command("create <name>").description("Create a project work state").requiredOption("--project <id>", "Project id").requiredOption("--category <category>", "backlog, unstarted, started, completed, or canceled").option("--position <number>", "Sort position").option("--default", "Use as default state", false).option("--json", "Output JSON", false).action((name, options) => commands.workStateCreate(name, options));
+	states.command("update <state-id>").description("Update a project work state").requiredOption("--project <id>", "Project id").option("--name <text>", "New name").option("--category <category>", "New lifecycle category").option("--position <number>", "New sort position").option("--default", "Use as default state", false).option("--json", "Output JSON", false).action((stateId, options) => commands.workStateUpdate(stateId, options));
+	states.command("delete <state-id>").description("Delete a state, optionally migrating its work items").requiredOption("--project <id>", "Project id").option("--migrate-to <state-id>", "Destination state for existing work items").option("--json", "Output JSON", false).action((stateId, options) => commands.workStateDelete(stateId, options));
 }
 //#endregion
 //#region src/cli/app/register-session-commands.ts
@@ -6142,4 +6200,4 @@ program.command("usage").description("Show observed LLM usage snapshots, history
 //#endregion
 export { program as nextclawCliProgram };
 
-//# sourceMappingURL=nextclaw-cli-app-cRvTVj04.js.map
+//# sourceMappingURL=nextclaw-cli-app-FS6IsYq6.js.map