@dayofweek/dcli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Day of Week
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,92 @@
+# @dayofweek/dcli
+
+CLI for the [Day of Week](https://dayofweek.com) AgTech platform.
+
+Read your organization's data and submit proposals for human review — nothing changes until you approve it.
+
+## Install
+
+```bash
+npm install -g @dayofweek/dcli
+```
+
+## Quick start
+
+```bash
+# Authenticate
+dcli auth set-token <your-token>
+
+# Browse your entities
+dcli read entities --json
+
+# Submit a proposal
+dcli agent propose --op create --table hierarchyEntities \
+  --title "New Farm" --source "my-agent" \
+  --parent <parentEntityId> --entity-type Farm \
+  --file payload.json
+
+# Check proposal status
+dcli agent proposals --status pending
+```
+
+## Agent integration
+
+```bash
+# Install the Agent Skill for AI agents
+dcli skill install
+
+# Works with OpenClaw, Claude Code, Cursor, VS Code Copilot,
+# Gemini CLI, Goose, OpenHands, and 25+ others
+```
+
+The skill follows the open [Agent Skills](https://agentskills.io) standard. After `dcli skill install`, any compatible agent on the machine discovers it automatically.
+
+## Commands
+
+### Authentication
+- `dcli auth login` — Authenticate via browser
+- `dcli auth set-token <token>` — Save a token locally
+- `dcli auth status` — Check token health
+- `dcli auth devices` — List your agent tokens
+- `dcli auth create-token <name>` — Create an agent token
+- `dcli auth revoke <id>` — Revoke a token
+
+### Reading data
+- `dcli read entities [--type Farm] [--parent <id>] [--limit 50]`
+- `dcli read entity <entityId>`
+- `dcli read produce [--entity <id>]`
+- `dcli read contacts [--entity <id>]`
+
+### Proposals
+- `dcli agent propose --op create --table <table> --title <title> [--file payload.json]`
+- `dcli agent propose-batch --label <label> --file batch.json`
+- `dcli agent proposals [--status pending]`
+- `dcli agent show <proposalId>`
+
+### Agent Skill
+- `dcli skill install` — Download skill (requires auth)
+- `dcli skill update` — Update to latest
+- `dcli skill status` — Check installed version
+
+## Configuration
+
+dcli stores its config at `~/.config/dayofweek/dcli.json`.
+
+Environment variables:
+- `DCLI_AUTH_TOKEN` — Auth token (overrides stored token)
+- `DCLI_API_URL` — Custom API base URL
+
+## REST API
+
+dcli talks to the Day of Week platform via a REST API. You can also call it directly:
+
+```bash
+curl -H "Authorization: Bearer dsk_xxx" \
+  "https://field.dayofweek.com/app/api/dcli/entities?type=Farm"
+```
+
+See the [API schema](https://field.dayofweek.com/app/api/dcli/schema) for all endpoints.
+
+## License
+
+MIT

package/dist/bin/dcli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/dcli.js

@@ -0,0 +1,276 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { DayOfWeekClient } from "../client.js";
+import { getToken, getApiUrl, saveConfig } from "../config.js";
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { createInterface } from "node:readline/promises";
+const program = new Command()
+    .name("dcli")
+    .description("CLI for the Day of Week AgTech platform")
+    .version("1.0.0")
+    .option("--token <token>", "Auth token (overrides DCLI_AUTH_TOKEN)")
+    .option("--api-url <url>", "API base URL (overrides DCLI_API_URL)")
+    .option("--json", "Output JSON (default for non-interactive use)");
+function getClient() {
+    const opts = program.opts();
+    const token = opts.token ?? getToken();
+    const apiUrl = opts.apiUrl ?? getApiUrl();
+    return new DayOfWeekClient(token, apiUrl);
+}
+function output(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+// ── Auth Commands ────────────────────────────────────────────────────────────
+const auth = program.command("auth").description("Authentication commands");
+auth
+    .command("login")
+    .description("Authenticate via browser")
+    .action(async () => {
+    const apiUrl = program.opts().apiUrl ?? getApiUrl();
+    const baseUrl = apiUrl.replace("/api/dcli", "");
+    const authUrl = `${baseUrl}/dcli/auth`;
+    console.log(`Opening browser for authentication...`);
+    console.log(`If the browser doesn't open, visit: ${authUrl}`);
+    const open = (await import("open")).default;
+    await open(authUrl);
+    console.log("\nAfter authenticating, copy the token and run:");
+    console.log("  export DCLI_AUTH_TOKEN=<your-token>");
+    console.log("  # or");
+    console.log("  dcli auth set-token <your-token>");
+});
+auth
+    .command("set-token <token>")
+    .description("Save a token to local config")
+    .action((token) => {
+    saveConfig({ authToken: token });
+    console.log("Token saved to ~/.config/dayofweek/dcli.json");
+});
+auth
+    .command("status")
+    .description("Check token health")
+    .action(async () => {
+    try {
+        const client = getClient();
+        const result = await client.checkAuth();
+        output(result);
+    }
+    catch (err) {
+        console.error(`Auth check failed: ${err.message}`);
+        process.exit(1);
+    }
+});
+auth
+    .command("devices")
+    .description("List your agent tokens")
+    .action(async () => {
+    const client = getClient();
+    const devices = await client.listDevices();
+    output(devices);
+});
+auth
+    .command("create-token <name>")
+    .description("Create an agent token")
+    .action(async (name) => {
+    const client = getClient();
+    const result = await client.createDevice(name);
+    console.log("\nToken created — copy it now, it won't be shown again:\n");
+    console.log(`  ${result.secret}\n`);
+    console.log("Set it as DCLI_AUTH_TOKEN in your agent's environment.");
+});
+auth
+    .command("revoke <deviceId>")
+    .description("Revoke an agent token")
+    .action(async (deviceId) => {
+    const client = getClient();
+    await client.revokeDevice(deviceId);
+    console.log("Token revoked.");
+});
+// ── Read Commands ────────────────────────────────────────────────────────────
+const read = program.command("read").description("Read platform data");
+read
+    .command("entities")
+    .description("List entities in your organization")
+    .option("--type <entityType>", "Filter by type (Farm, Producer, Restaurant, ...)")
+    .option("--parent <entityId>", "List children of an entity")
+    .option("--limit <count>", "Max results", parseInt)
+    .action(async (opts) => {
+    const client = getClient();
+    const result = await client.listEntities(opts);
+    output(result);
+});
+read
+    .command("entity <entityId>")
+    .description("Get entity details")
+    .action(async (entityId) => {
+    const client = getClient();
+    const result = await client.getEntity(entityId);
+    output(result);
+});
+read
+    .command("produce")
+    .description("List produce profiles")
+    .option("--entity <entityId>", "Filter by entity")
+    .option("--limit <count>", "Max results", parseInt)
+    .action(async (opts) => {
+    const client = getClient();
+    const result = await client.listProduce(opts);
+    output(result);
+});
+read
+    .command("contacts")
+    .description("List contacts and memberships")
+    .option("--entity <entityId>", "Filter by entity")
+    .option("--limit <count>", "Max results", parseInt)
+    .action(async (opts) => {
+    const client = getClient();
+    const result = await client.listContacts(opts);
+    output(result);
+});
+// ── Agent Commands ───────────────────────────────────────────────────────────
+const agent = program.command("agent").description("Submit and view proposals");
+agent
+    .command("propose")
+    .description("Submit a proposal for review")
+    .requiredOption("--op <operation>", "Operation: create, update, or delete")
+    .requiredOption("--table <table>", "Target table (e.g. hierarchyEntities)")
+    .requiredOption("--title <title>", "Human-readable title")
+    .option("--description <text>", "Reasoning/evidence")
+    .option("--source <agent>", "Agent identifier")
+    .option("--source-url <url>", "Evidence URL")
+    .option("--confidence <score>", "Confidence 0-1", parseFloat)
+    .option("--parent <entityId>", "Parent entity ID")
+    .option("--entity-type <type>", "Entity type (Farm, Producer, ...)")
+    .option("--file <path>", "Read payload from JSON file (- for stdin)")
+    .option("--payload <json>", "Inline JSON payload")
+    .action(async (opts) => {
+    let payload = opts.payload ? JSON.parse(opts.payload) : {};
+    if (opts.file) {
+        const content = opts.file === "-"
+            ? await readStdin()
+            : readFileSync(opts.file, "utf-8");
+        payload = JSON.parse(content);
+    }
+    const client = getClient();
+    const result = await client.submitProposal({
+        operation: opts.op,
+        targetTable: opts.table,
+        title: opts.title,
+        description: opts.description,
+        payload,
+        sourceAgent: opts.source,
+        sourceUrl: opts.sourceUrl,
+        confidence: opts.confidence,
+        proposedParentId: opts.parent,
+        proposedEntityType: opts.entityType,
+    });
+    output(result);
+});
+agent
+    .command("propose-batch")
+    .description("Submit multiple proposals")
+    .requiredOption("--label <label>", "Batch label")
+    .option("--source <agent>", "Agent identifier")
+    .requiredOption("--file <path>", "JSON file with proposals array (- for stdin)")
+    .action(async (opts) => {
+    const content = opts.file === "-"
+        ? await readStdin()
+        : readFileSync(opts.file, "utf-8");
+    const proposals = JSON.parse(content);
+    const client = getClient();
+    const result = await client.submitBatch({
+        batchLabel: opts.label,
+        sourceAgent: opts.source,
+        proposals: Array.isArray(proposals) ? proposals : [proposals],
+    });
+    output(result);
+});
+agent
+    .command("proposals")
+    .description("List proposals")
+    .option("--status <status>", "Filter: pending, approved, rejected, failed")
+    .option("--source <source>", "Filter: discovery, agent, manual")
+    .option("--limit <count>", "Max results", parseInt)
+    .action(async (opts) => {
+    const client = getClient();
+    const result = await client.listProposals(opts);
+    output(result);
+});
+agent
+    .command("show <proposalId>")
+    .description("Show proposal details")
+    .action(async (proposalId) => {
+    const client = getClient();
+    const result = await client.getProposal(proposalId);
+    output(result);
+});
+// ── Skill Commands ───────────────────────────────────────────────────────────
+const skill = program.command("skill").description("Manage the Day of Week agent skill");
+skill
+    .command("install")
+    .description("Install the agent skill (requires valid auth)")
+    .option("--dir <path>", "Custom install directory")
+    .action(async (opts) => {
+    const client = getClient();
+    const bundle = await client.getSkillBundle();
+    const targetDir = opts.dir ?? join(homedir(), ".agents", "skills", bundle.name);
+    let filesWritten = 0;
+    for (const file of bundle.files) {
+        const filePath = join(targetDir, file.path);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, file.content, "utf-8");
+        filesWritten++;
+    }
+    console.log(`Installed ${filesWritten} files to ${targetDir}`);
+    console.log("Any compatible agent will discover the skill automatically.");
+});
+skill
+    .command("update")
+    .description("Update the skill to the latest version")
+    .option("--dir <path>", "Custom install directory")
+    .action(async (opts) => {
+    // Same as install — overwrites
+    const client = getClient();
+    const bundle = await client.getSkillBundle();
+    const targetDir = opts.dir ?? join(homedir(), ".agents", "skills", bundle.name);
+    let filesWritten = 0;
+    for (const file of bundle.files) {
+        const filePath = join(targetDir, file.path);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, file.content, "utf-8");
+        filesWritten++;
+    }
+    console.log(`Updated ${filesWritten} files in ${targetDir}`);
+});
+skill
+    .command("status")
+    .description("Check if the skill is installed")
+    .option("--dir <path>", "Custom install directory")
+    .action(async (opts) => {
+    const dir = opts.dir ?? join(homedir(), ".agents", "skills", "dayofweek-platform");
+    const skillPath = join(dir, "SKILL.md");
+    if (!existsSync(skillPath)) {
+        console.log("Not installed. Run: dcli skill install");
+        process.exit(1);
+    }
+    const content = readFileSync(skillPath, "utf-8");
+    const versionMatch = content.match(/version:\s*"([^"]+)"/);
+    console.log(`Installed at: ${dir}`);
+    console.log(`Version: ${versionMatch?.[1] ?? "unknown"}`);
+    console.log("\nTo update: dcli skill update");
+});
+// ── Helpers ──────────────────────────────────────────────────────────────────
+async function readStdin() {
+    const chunks = [];
+    const rl = createInterface({ input: process.stdin });
+    for await (const line of rl) {
+        chunks.push(line);
+    }
+    return chunks.join("\n");
+}
+// ── Run ──────────────────────────────────────────────────────────────────────
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err.message ?? err);
+    process.exit(1);
+});

package/dist/client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * HTTP client for the Day of Week platform REST API.
+ * All calls go through the proxy at field.dayofweek.com/app/api/dcli.
+ */
+export declare class ApiError extends Error {
+    status: number;
+    constructor(status: number, message: string);
+}
+export declare class DayOfWeekClient {
+    private baseUrl;
+    private token;
+    constructor(token: string, baseUrl?: string);
+    checkAuth(): Promise<{
+        status: string;
+        authenticated: boolean;
+    }>;
+    listDevices(): Promise<Array<{
+        _id: string;
+        name: string;
+        secretPreview: string;
+        lastUsedAt: number;
+        createdAt: number;
+    }>>;
+    createDevice(name: string): Promise<{
+        secret: string;
+    }>;
+    revokeDevice(deviceId: string): Promise<{
+        success: boolean;
+    }>;
+    listEntities(opts?: {
+        type?: string;
+        parent?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    getEntity(entityId: string): Promise<any>;
+    listProduce(opts?: {
+        entity?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    listContacts(opts?: {
+        entity?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    listProposals(opts?: {
+        status?: string;
+        source?: string;
+        limit?: number;
+    }): Promise<any[]>;
+    getProposal(proposalId: string): Promise<any>;
+    submitProposal(proposal: Record<string, unknown>): Promise<any>;
+    submitBatch(batch: {
+        batchLabel: string;
+        sourceAgent?: string;
+        proposals: any[];
+    }): Promise<any>;
+    getSkillBundle(): Promise<{
+        name: string;
+        version: string;
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+    }>;
+    getSchema(): Promise<any>;
+    private get;
+    private post;
+    private delete;
+}

package/dist/client.js

@@ -0,0 +1,153 @@
+/**
+ * HTTP client for the Day of Week platform REST API.
+ * All calls go through the proxy at field.dayofweek.com/app/api/dcli.
+ */
+const DEFAULT_BASE_URL = "https://field.dayofweek.com/app/api/dcli";
+export class ApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "ApiError";
+    }
+}
+export class DayOfWeekClient {
+    baseUrl;
+    token;
+    constructor(token, baseUrl) {
+        this.token = token;
+        this.baseUrl = baseUrl ?? process.env.DCLI_API_URL ?? DEFAULT_BASE_URL;
+    }
+    // ── Auth ──────────────────────────────────────────────────────────────────
+    async checkAuth() {
+        return this.get("/auth/status");
+    }
+    async listDevices() {
+        return this.get("/auth/devices");
+    }
+    async createDevice(name) {
+        return this.post("/auth/devices", { name });
+    }
+    async revokeDevice(deviceId) {
+        return this.delete(`/auth/devices/${deviceId}`);
+    }
+    // ── Read ──────────────────────────────────────────────────────────────────
+    async listEntities(opts) {
+        const params = new URLSearchParams();
+        if (opts?.type)
+            params.set("type", opts.type);
+        if (opts?.parent)
+            params.set("parent", opts.parent);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/entities${qs ? `?${qs}` : ""}`);
+    }
+    async getEntity(entityId) {
+        return this.get(`/entities/${entityId}`);
+    }
+    async listProduce(opts) {
+        const params = new URLSearchParams();
+        if (opts?.entity)
+            params.set("entity", opts.entity);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/produce${qs ? `?${qs}` : ""}`);
+    }
+    async listContacts(opts) {
+        const params = new URLSearchParams();
+        if (opts?.entity)
+            params.set("entity", opts.entity);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/contacts${qs ? `?${qs}` : ""}`);
+    }
+    // ── Proposals ─────────────────────────────────────────────────────────────
+    async listProposals(opts) {
+        const params = new URLSearchParams();
+        if (opts?.status)
+            params.set("status", opts.status);
+        if (opts?.source)
+            params.set("source", opts.source);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        return this.get(`/proposals${qs ? `?${qs}` : ""}`);
+    }
+    async getProposal(proposalId) {
+        return this.get(`/proposals/${proposalId}`);
+    }
+    async submitProposal(proposal) {
+        return this.post("/proposals", proposal);
+    }
+    async submitBatch(batch) {
+        return this.post("/proposals/batch", batch);
+    }
+    // ── Skill ─────────────────────────────────────────────────────────────────
+    async getSkillBundle() {
+        return this.get("/skill");
+    }
+    // ── Schema ────────────────────────────────────────────────────────────────
+    async getSchema() {
+        // Schema endpoint doesn't require auth
+        const res = await fetch(`${this.baseUrl}/schema`);
+        if (!res.ok)
+            throw new ApiError(res.status, await res.text());
+        return res.json();
+    }
+    // ── HTTP helpers ──────────────────────────────────────────────────────────
+    async get(path) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            headers: { Authorization: `Bearer ${this.token}` },
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            try {
+                const json = JSON.parse(body);
+                throw new ApiError(res.status, json.error ?? body);
+            }
+            catch (e) {
+                if (e instanceof ApiError)
+                    throw e;
+                throw new ApiError(res.status, body);
+            }
+        }
+        return res.json();
+    }
+    async post(path, body) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            try {
+                const json = JSON.parse(text);
+                throw new ApiError(res.status, json.error ?? text);
+            }
+            catch (e) {
+                if (e instanceof ApiError)
+                    throw e;
+                throw new ApiError(res.status, text);
+            }
+        }
+        return res.json();
+    }
+    async delete(path) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            method: "DELETE",
+            headers: { Authorization: `Bearer ${this.token}` },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new ApiError(res.status, text);
+        }
+        return res.json();
+    }
+}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+export interface DcliConfig {
+    authToken?: string;
+    apiUrl?: string;
+}
+export declare function loadConfig(): DcliConfig;
+export declare function saveConfig(updates: Partial<DcliConfig>): void;
+export declare function getToken(): string;
+export declare function getApiUrl(): string;

package/dist/config.js

@@ -0,0 +1,38 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const CONFIG_DIR = join(homedir(), ".config", "dayofweek");
+const CONFIG_FILE = join(CONFIG_DIR, "dcli.json");
+export function loadConfig() {
+    try {
+        if (existsSync(CONFIG_FILE)) {
+            return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+        }
+    }
+    catch {
+        // Ignore malformed config
+    }
+    return {};
+}
+export function saveConfig(updates) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    const existing = loadConfig();
+    const merged = { ...existing, ...updates };
+    writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), "utf-8");
+}
+export function getToken() {
+    const token = process.env.DCLI_AUTH_TOKEN ??
+        process.env.DCLI_TOKEN ??
+        loadConfig().authToken;
+    if (!token) {
+        console.error("No auth token found.");
+        console.error("Set DCLI_AUTH_TOKEN or run: dcli auth login");
+        process.exit(1);
+    }
+    return token;
+}
+export function getApiUrl() {
+    return (process.env.DCLI_API_URL ??
+        loadConfig().apiUrl ??
+        "https://field.dayofweek.com/app/api/dcli");
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@dayofweek/dcli",
+  "version": "1.0.0",
+  "description": "CLI for the Day of Week AgTech platform — read data and submit proposals for review",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "dcli": "dist/bin/dcli.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/bin/dcli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^14.0.0",
+    "open": "^11.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dayofweek/dcli.git"
+  },
+  "homepage": "https://github.com/dayofweek/dcli#readme",
+  "keywords": [
+    "dayofweek",
+    "agtech",
+    "cli",
+    "agent",
+    "food-supply-chain"
+  ]
+}