@dac-tech-team-tw/itsaplan-cli 0.0.0-stage → 0.1.0

package/dist/writes.d.ts

@@ -0,0 +1,8 @@
+import { type Actor, type Context, type ObjectData, type Result } from "./contracts.js";
+import { type IssueOptions } from "./issues.js";
+/** Preflight failures are never mistaken for a write with an unknown outcome. */
+export declare function withWrite(options: IssueOptions, operation: (actor: Actor) => Promise<Result>): Promise<Result>;
+export declare function preview(ctx: Context, actor: Actor, data: ObjectData, path: string, body: ObjectData, warnings?: string[]): Promise<Result>;
+export declare function writeFailure(error: unknown, data: ObjectData, actor: Actor): Result;
+export declare function verificationFailed(data: ObjectData, actor: Actor): Result;
+export declare function applied(data: ObjectData, actor: Actor): Result;

package/dist/writes.js

@@ -0,0 +1,57 @@
+import { CliError, } from "./contracts.js";
+import { actorFor, me, writeFailure as issueWriteFailure, verificationFailed as issueVerificationFailed, } from "./issues.js";
+/** Preflight failures are never mistaken for a write with an unknown outcome. */
+export async function withWrite(options, operation) {
+    let actor;
+    try {
+        actor = actorFor(options);
+        return await operation(actor);
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            error.details = {
+                ...error.details,
+                outcome: "not_applied",
+                verification: "not_run",
+                ...(actor ? { meta: { actor } } : {}),
+                retryable: false,
+            };
+            throw error;
+        }
+        throw new CliError("WRITE_PREFLIGHT_FAILED", "Write preflight failed; no write was sent", 1, {
+            outcome: "not_applied",
+            verification: "not_run",
+            ...(actor ? { meta: { actor } } : {}),
+            retryable: false,
+        });
+    }
+}
+export async function preview(ctx, actor, data, path, body, warnings = []) {
+    return {
+        data: {
+            ...data,
+            dryRun: true,
+            identity: await me(ctx),
+            request: { method: "POST", path, body },
+            warnings: [
+                "Preview sends no writes and does not guarantee server permissions or concurrent state.",
+                ...warnings,
+            ],
+        },
+        meta: { actor },
+        outcome: "not_applied",
+        verification: "not_run",
+    };
+}
+export function writeFailure(error, data, actor) {
+    const result = issueWriteFailure(error, data, actor, "document or relation");
+    if (result.outcome === "unknown")
+        delete data.changed;
+    return result;
+}
+export function verificationFailed(data, actor) {
+    return issueVerificationFailed(data, actor, "document or relation");
+}
+export function applied(data, actor) {
+    return { data, meta: { actor }, outcome: "applied", verification: "passed" };
+}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@dac-tech-team-tw/itsaplan-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Composable It's a Plan CLI for humans and coding agents",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dac-tech-team-tw/itsaplan-cli.git"
+  },
+  "packageManager": "pnpm@12.14.0",
+  "bin": {
+    "iap": "dist/cli.js",
+    "itsaplan": "dist/cli.js"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "test": "tsx --test test/*.test.ts",
+    "format": "prettier --write src test package.json tsconfig*.json",
+    "prepack": "npm run build",
+    "install-local": "node scripts/install-local.mjs"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.10.1",
+    "@napi-rs/keyring": "^1.2.0",
+    "commander": "^14.0.2",
+    "smol-toml": "^1.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}