@loxtep/sdk 0.2.1 → 0.3.0

package/dist/cli/commands/improvements-cmd.d.ts

@@ -0,0 +1,44 @@
+/**
+ * CLI: loxtep improvements list|apply|reject
+ *
+ * - `list` — list improvements for the authenticated org (R8.3)
+ * - `apply <id>` — write proposed_change into the module file atomically, set status to applied (R8.4, R8.7)
+ * - `reject <id>` — set status to rejected (R8.5)
+ * - Guard unknown-id/non-`proposed` with non-zero exit and no state change (R8.6)
+ *
+ * Requirements: 8.3, 8.4, 8.5, 8.6, 8.7
+ */
+import type { LoxtepClient } from '../../client/loxtep-client.js';
+import { type CliResult } from '../project-context.js';
+/**
+ * Execute `loxtep improvements list`.
+ *
+ * Lists improvements from the API and prints them in a readable format.
+ * Requires authentication but does NOT require an attached project.
+ */
+export declare function runImprovementsListCommand(client: LoxtepClient, options?: {
+    status?: string;
+    workflow_name?: string;
+}): Promise<CliResult>;
+/**
+ * Execute `loxtep improvements apply <id>`.
+ *
+ * 1. Fetches the improvement from the API (validates it exists and is `proposed`)
+ * 2. Resolves the target workflow module file
+ * 3. Writes the `proposed_change` into the file atomically (temp + rename)
+ * 4. Calls the API to set status to `applied`
+ * 5. On any file-write failure: file stays unchanged, status stays `proposed` (R8.7)
+ *
+ * Requirements: 8.4, 8.6, 8.7
+ */
+export declare function runImprovementsApplyCommand(client: LoxtepClient, id: string, cwd?: string): Promise<CliResult>;
+/**
+ * Execute `loxtep improvements reject <id>`.
+ *
+ * Sets the improvement status to `rejected` on the server.
+ * Guards unknown-id and non-`proposed` status with non-zero exit (R8.6).
+ *
+ * Requirements: 8.5, 8.6
+ */
+export declare function runImprovementsRejectCommand(client: LoxtepClient, id: string): Promise<CliResult>;
+//# sourceMappingURL=improvements-cmd.d.ts.map

package/dist/cli/commands/improvements-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvements-cmd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/improvements-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,SAAS,CAAC,CAsCpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,MAAM,EACV,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,CAAC,CAuFpB;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,YAAY,EACpB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,SAAS,CAAC,CAmBpB"}

package/dist/cli/commands/improvements-cmd.js

@@ -0,0 +1,215 @@
+/**
+ * CLI: loxtep improvements list|apply|reject
+ *
+ * - `list` — list improvements for the authenticated org (R8.3)
+ * - `apply <id>` — write proposed_change into the module file atomically, set status to applied (R8.4, R8.7)
+ * - `reject <id>` — set status to rejected (R8.5)
+ * - Guard unknown-id/non-`proposed` with non-zero exit and no state change (R8.6)
+ *
+ * Requirements: 8.3, 8.4, 8.5, 8.6, 8.7
+ */
+import { writeFile, rename, rm } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { requireProject, preconditionToCliResult, } from '../project-context.js';
+/**
+ * Execute `loxtep improvements list`.
+ *
+ * Lists improvements from the API and prints them in a readable format.
+ * Requires authentication but does NOT require an attached project.
+ */
+export async function runImprovementsListCommand(client, options) {
+    try {
+        const filters = {};
+        if (options?.status) {
+            if (!['proposed', 'applied', 'rejected'].includes(options.status)) {
+                return {
+                    exitCode: 1,
+                    stdout: [],
+                    stderr: [`Invalid status filter: '${options.status}'. Must be one of: proposed, applied, rejected.`],
+                };
+            }
+            filters.status = options.status;
+        }
+        if (options?.workflow_name) {
+            filters.workflow_name = options.workflow_name;
+        }
+        const result = await client.improvements.list(filters);
+        const { improvements } = result;
+        if (improvements.length === 0) {
+            return { exitCode: 0, stdout: ['No improvements found.'], stderr: [] };
+        }
+        const lines = [];
+        for (const imp of improvements) {
+            lines.push(`${imp.id}  [${imp.status}]  ${imp.workflow_name}`);
+            if (imp.rationale) {
+                lines.push(`  Rationale: ${imp.rationale}`);
+            }
+            lines.push(`  Created: ${imp.created_at}`);
+            lines.push('');
+        }
+        return { exitCode: 0, stdout: lines, stderr: [] };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { exitCode: 1, stdout: [], stderr: [`Failed to list improvements: ${message}`] };
+    }
+}
+/**
+ * Execute `loxtep improvements apply <id>`.
+ *
+ * 1. Fetches the improvement from the API (validates it exists and is `proposed`)
+ * 2. Resolves the target workflow module file
+ * 3. Writes the `proposed_change` into the file atomically (temp + rename)
+ * 4. Calls the API to set status to `applied`
+ * 5. On any file-write failure: file stays unchanged, status stays `proposed` (R8.7)
+ *
+ * Requirements: 8.4, 8.6, 8.7
+ */
+export async function runImprovementsApplyCommand(client, id, cwd) {
+    const workingDir = cwd ?? process.cwd();
+    // Resolve the project directory (need it to locate workflow files)
+    const projectResult = requireProject(workingDir);
+    if (!projectResult.ok) {
+        return preconditionToCliResult(projectResult.failure);
+    }
+    const { projectDir } = projectResult;
+    // 1. Fetch the improvement from the list endpoint to get its details
+    let improvement;
+    try {
+        const result = await client.improvements.list();
+        improvement = result.improvements.find(imp => imp.id === id);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { exitCode: 1, stdout: [], stderr: [`Failed to fetch improvement: ${message}`] };
+    }
+    if (!improvement) {
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [`Error: Improvement '${id}' not found.`],
+        };
+    }
+    // R8.6: Guard non-proposed status
+    if (improvement.status !== 'proposed') {
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [
+                `Error: Improvement '${id}' is in status '${improvement.status}', not 'proposed'. Only proposed improvements can be applied.`,
+            ],
+        };
+    }
+    // 2. Resolve the target workflow module file
+    const workflowFile = resolveWorkflowFilePath(projectDir, improvement.workflow_name);
+    if (!workflowFile) {
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [
+                `Error: Cannot locate workflow module file for '${improvement.workflow_name}'. Write failed — status remains 'proposed'.`,
+            ],
+        };
+    }
+    // 3. Write the proposed_change atomically (R8.7: on failure, file unchanged + status stays proposed)
+    try {
+        await atomicWriteFile(workflowFile, improvement.proposed_change);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [
+                `Error: Failed to write proposed change to '${workflowFile}': ${message}. File unchanged — status remains 'proposed'.`,
+            ],
+        };
+    }
+    // 4. Set status to 'applied' on the server
+    try {
+        await client.improvements.apply(id);
+    }
+    catch (err) {
+        // File was already written successfully, but API update failed.
+        // Per R8.4, the write happened; per R8.7 failure semantics are about write failure.
+        // Since the file was written, report the API error but the file change stands.
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [
+                `Warning: Proposed change was written to '${workflowFile}', but failed to update status on server: ${message}`,
+            ],
+        };
+    }
+    return {
+        exitCode: 0,
+        stdout: [`Applied improvement '${id}' — wrote proposed change to '${workflowFile}' and set status to 'applied'.`],
+        stderr: [],
+    };
+}
+/**
+ * Execute `loxtep improvements reject <id>`.
+ *
+ * Sets the improvement status to `rejected` on the server.
+ * Guards unknown-id and non-`proposed` status with non-zero exit (R8.6).
+ *
+ * Requirements: 8.5, 8.6
+ */
+export async function runImprovementsRejectCommand(client, id) {
+    try {
+        await client.improvements.reject(id);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        // The API returns 404 for unknown id and 409 for non-proposed status.
+        // Both are surfaced as errors — no state change (R8.6).
+        return {
+            exitCode: 1,
+            stdout: [],
+            stderr: [`Error: Failed to reject improvement '${id}': ${message}`],
+        };
+    }
+    return {
+        exitCode: 0,
+        stdout: [`Rejected improvement '${id}' — status set to 'rejected'.`],
+        stderr: [],
+    };
+}
+/**
+ * Resolve the file path for a workflow module by name.
+ *
+ * Searches for `workflows/<workflow_name>.ts` relative to the project directory.
+ * Returns the full path if the file exists, or null if not found.
+ */
+function resolveWorkflowFilePath(projectDir, workflowName) {
+    // Primary: workflows/<name>.ts
+    const primary = join(projectDir, 'workflows', `${workflowName}.ts`);
+    if (existsSync(primary))
+        return primary;
+    // Fallback: workflows/<name>/index.ts
+    const indexPath = join(projectDir, 'workflows', workflowName, 'index.ts');
+    if (existsSync(indexPath))
+        return indexPath;
+    return null;
+}
+/**
+ * Write content to a file atomically using a temp file + rename pattern.
+ *
+ * On any failure, the original file remains byte-unchanged (R8.7).
+ */
+async function atomicWriteFile(filePath, content) {
+    const dir = dirname(filePath);
+    const tmpPath = join(dir, `.tmp-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+    try {
+        await writeFile(tmpPath, content, 'utf-8');
+        await rename(tmpPath, filePath);
+    }
+    catch (err) {
+        // Best-effort cleanup of temp file
+        await rm(tmpPath, { force: true }).catch(() => undefined);
+        throw err;
+    }
+}
+//# sourceMappingURL=improvements-cmd.js.map

package/dist/cli/commands/improvements-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improvements-cmd.js","sourceRoot":"","sources":["../../../src/cli/commands/improvements-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAY,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EACL,cAAc,EACd,uBAAuB,GAExB,MAAM,uBAAuB,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAoB,EACpB,OAAqD;IAErD,IAAI,CAAC;QACH,MAAM,OAAO,GAA6E,EAAE,CAAC;QAC7F,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClE,OAAO;oBACL,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,EAAE;oBACV,MAAM,EAAE,CAAC,2BAA2B,OAAO,CAAC,MAAM,iDAAiD,CAAC;iBACrG,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAA6C,CAAC;QACzE,CAAC;QACD,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;YAC3B,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAChD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QAEhC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzE,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC;YAC/D,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,gCAAgC,OAAO,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAoB,EACpB,EAAU,EACV,GAAY;IAEZ,MAAM,UAAU,GAAG,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAExC,mEAAmE;IACnE,MAAM,aAAa,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC;QACtB,OAAO,uBAAuB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACxD,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,GAAG,aAAa,CAAC;IAErC,qEAAqE;IACrE,IAAI,WAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAChD,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,gCAAgC,OAAO,EAAE,CAAC,EAAE,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC;SAClD,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,WAAW,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,uBAAuB,EAAE,mBAAmB,WAAW,CAAC,MAAM,+DAA+D;aAC9H;SACF,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,YAAY,GAAG,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;IACpF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,kDAAkD,WAAW,CAAC,aAAa,8CAA8C;aAC1H;SACF,CAAC;IACJ,CAAC;IAED,qGAAqG;IACrG,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,8CAA8C,YAAY,MAAM,OAAO,+CAA+C;aACvH;SACF,CAAC;IACJ,CAAC;IAED,2CAA2C;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,gEAAgE;QAChE,oFAAoF;QACpF,+EAA+E;QAC/E,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,4CAA4C,YAAY,6CAA6C,OAAO,EAAE;aAC/G;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,wBAAwB,EAAE,iCAAiC,YAAY,gCAAgC,CAAC;QACjH,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAoB,EACpB,EAAU;IAEV,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,sEAAsE;QACtE,wDAAwD;QACxD,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,CAAC,wCAAwC,EAAE,MAAM,OAAO,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,yBAAyB,EAAE,+BAA+B,CAAC;QACpE,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,uBAAuB,CAAC,UAAkB,EAAE,YAAoB;IACvE,+BAA+B;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC;IACpE,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAExC,sCAAsC;IACtC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAC1E,IAAI,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAClB,GAAG,EACH,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAC5D,CAAC;IACF,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mCAAmC;QACnC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC1D,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli/commands/init-cmd.d.ts

@@ -0,0 +1,78 @@
+/**
+ * `loxtep init [--template <slug>] [--create-repo|--from-repo]`
+ *
+ * Scaffolds a new Loxtep project:
+ *   - `.loxtep/project.json` + `domains/` + `connectors/` + `workflows/` + `data-products/`
+ *   - With `--template <slug>`: resolves from the catalog and materializes full
+ *     structure incl. `AGENTS.md` + default `.loxtep/skills/<slug>.yaml`.
+ *   - Repo flags → `github_action` on `create_project`:
+ *     `--create-repo` → `create_new` (private default),
+ *     `--from-repo <url>` → `import_existing`,
+ *     neither → `none`,
+ *     both → reject (exit 1).
+ *   - Always prints Getting Started + Quick Reference links (R11.7).
+ *   - Auto-runs `generate` when authed+attached; fails the whole `init` if
+ *     `generate` fails (R16.3, R16.4).
+ *   - Prints login/attach/generate guidance otherwise (R16.5).
+ *
+ * Requirements: 1.1, 1.2, 11.7, 16.1, 16.2, 16.3, 16.4, 16.5, 17.4, 17.5, 17.6
+ */
+import type { CliResult } from '../project-context.js';
+import type { LoxtepClient } from '../../client/loxtep-client.js';
+export type GithubAction = 'create_new' | 'import_existing' | 'none';
+export interface RepoFlagInput {
+    createRepo?: string | boolean;
+    fromRepo?: string;
+}
+/**
+ * Map CLI `--create-repo` / `--from-repo` flags to the `github_action` value
+ * for `create_project`.
+ *
+ * - `--create-repo` → `create_new` (private default) (R17.4)
+ * - `--from-repo <url>` → `import_existing` (R17.5)
+ * - neither → `none` (R17.6)
+ * - both → reject (returns an error string)
+ */
+export declare function repoFlagsToGithubAction(flags: RepoFlagInput): {
+    ok: true;
+    action: GithubAction;
+    repoName?: string;
+    importUrl?: string;
+} | {
+    ok: false;
+    error: string;
+};
+export interface InitOptions {
+    /** Current working directory to scaffold into. */
+    cwd: string;
+    /** Template slug to use (`--template <slug>`). */
+    templateSlug?: string;
+    /** `--create-repo [name]` flag. */
+    createRepo?: string | boolean;
+    /** `--from-repo <url>` flag. */
+    fromRepo?: string;
+    /** Project name (defaults to directory basename). */
+    name?: string;
+    /**
+     * Optional pre-authenticated client. When provided and the project is
+     * attached, the init will auto-run generate.
+     */
+    client?: LoxtepClient | null;
+    /**
+     * Optional instance_id. When provided together with `apiUrl`, the project is
+     * considered already attached, enabling auto-generate (R16.3).
+     */
+    instanceId?: string;
+    /**
+     * Optional API URL. When provided together with `instanceId`, the project is
+     * considered already attached, enabling auto-generate (R16.3).
+     */
+    apiUrl?: string;
+    /**
+     * Optional generate function (injected for testability). If provided, called
+     * after scaffold when authed+attached. Receives cwd and the client.
+     */
+    runGenerate?: (cwd: string, client: LoxtepClient) => Promise<CliResult>;
+}
+export declare function runInitCommand(options: InitOptions): Promise<CliResult>;
+//# sourceMappingURL=init-cmd.d.ts.map

package/dist/cli/commands/init-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-cmd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAelE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,aAAa,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAkB1G;AAMD,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACzE;AAqED,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAyJ7E"}

package/dist/cli/commands/init-cmd.js

@@ -0,0 +1,250 @@
+/**
+ * `loxtep init [--template <slug>] [--create-repo|--from-repo]`
+ *
+ * Scaffolds a new Loxtep project:
+ *   - `.loxtep/project.json` + `domains/` + `connectors/` + `workflows/` + `data-products/`
+ *   - With `--template <slug>`: resolves from the catalog and materializes full
+ *     structure incl. `AGENTS.md` + default `.loxtep/skills/<slug>.yaml`.
+ *   - Repo flags → `github_action` on `create_project`:
+ *     `--create-repo` → `create_new` (private default),
+ *     `--from-repo <url>` → `import_existing`,
+ *     neither → `none`,
+ *     both → reject (exit 1).
+ *   - Always prints Getting Started + Quick Reference links (R11.7).
+ *   - Auto-runs `generate` when authed+attached; fails the whole `init` if
+ *     `generate` fails (R16.3, R16.4).
+ *   - Prints login/attach/generate guidance otherwise (R16.5).
+ *
+ * Requirements: 1.1, 1.2, 11.7, 16.1, 16.2, 16.3, 16.4, 16.5, 17.4, 17.5, 17.6
+ */
+import { join } from 'node:path';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { PROJECT_DIR_NAME, writeProjectConfig, } from '../project-context.js';
+/* ------------------------------------------------------------------ */
+/*  Doc links (R11.7)                                                  */
+/* ------------------------------------------------------------------ */
+const GETTING_STARTED_URL = 'https://docs.loxtep.io/getting-started';
+const QUICK_REFERENCE_URL = 'https://docs.loxtep.io/quick-reference';
+/**
+ * Map CLI `--create-repo` / `--from-repo` flags to the `github_action` value
+ * for `create_project`.
+ *
+ * - `--create-repo` → `create_new` (private default) (R17.4)
+ * - `--from-repo <url>` → `import_existing` (R17.5)
+ * - neither → `none` (R17.6)
+ * - both → reject (returns an error string)
+ */
+export function repoFlagsToGithubAction(flags) {
+    const hasCreate = flags.createRepo !== undefined && flags.createRepo !== false;
+    const hasFrom = flags.fromRepo !== undefined && flags.fromRepo !== '';
+    if (hasCreate && hasFrom) {
+        return { ok: false, error: 'Cannot specify both --create-repo and --from-repo.' };
+    }
+    if (hasCreate) {
+        const repoName = typeof flags.createRepo === 'string' ? flags.createRepo : undefined;
+        return { ok: true, action: 'create_new', repoName };
+    }
+    if (hasFrom) {
+        return { ok: true, action: 'import_existing', importUrl: flags.fromRepo };
+    }
+    return { ok: true, action: 'none' };
+}
+/* ------------------------------------------------------------------ */
+/*  Scaffold helpers                                                   */
+/* ------------------------------------------------------------------ */
+const STANDARD_DIRS = ['domains', 'connectors', 'workflows', 'data-products'];
+async function ensureDir(dir) {
+    await mkdir(dir, { recursive: true });
+}
+function buildDefaultAgentsMd(templateSlug, template) {
+    return `# AGENTS.md — ${template.name || templateSlug}
+
+This project was scaffolded from the \`${templateSlug}\` template.
+
+## MCP tools
+
+Connect to the Loxtep MCP server for full platform access:
+
+\`\`\`json
+{ "mcpServers": { "loxtep": { "url": "https://mcp.loxtep.io/ai/mcp/stream" } } }
+\`\`\`
+
+## SDK methods
+
+- \`LoxtepClient.fromWorkspace()\` — auto-configure from \`.loxtep/project.json\`
+- \`defineDataWorkflow({ name, triggers, handler })\` — code-first workflow authoring
+- \`workspace.dataProducts.*\` / \`workspace.connectors.*\` — typed constants (after \`loxtep generate\`)
+
+## Skill scope
+
+Default skill: \`.loxtep/skills/${templateSlug}.yaml\`
+`;
+}
+function buildDefaultSkillYaml(templateSlug) {
+    return `# Default skill for the ${templateSlug} template.
+# Edit scope and permissions to match your project's resources.
+name: ${templateSlug}
+description: Default skill scope for the ${templateSlug} template
+scope:
+  data_products: []
+  connectors: []
+  workflows: []
+  domains: []
+  queues: []
+permissions:
+  data_products:
+    - read
+    - write
+  connectors:
+    - read
+  workflows:
+    - read
+    - write
+    - create
+  domains:
+    - read
+  queues:
+    - read
+`;
+}
+/* ------------------------------------------------------------------ */
+/*  Main init logic                                                    */
+/* ------------------------------------------------------------------ */
+export async function runInitCommand(options) {
+    const { cwd, templateSlug, createRepo, fromRepo, client } = options;
+    const stdout = [];
+    const stderr = [];
+    // --- Validate repo flags (R17.4/R17.5/R17.6: both → reject) ---
+    const repoResult = repoFlagsToGithubAction({ createRepo, fromRepo });
+    if (!repoResult.ok) {
+        return { exitCode: 1, stdout: [], stderr: [repoResult.error] };
+    }
+    // --- Resolve template when requested (R1.2, R16.1, R16.2) ---
+    let template;
+    if (templateSlug && client) {
+        try {
+            // Try to find by slug search first; the catalog may return by id or name
+            const templates = await client.templates.list({ search: templateSlug });
+            template = templates.items.find((t) => t.name === templateSlug ||
+                t.template_id === templateSlug ||
+                t.metadata?.slug === templateSlug);
+            if (!template) {
+                // Fallback: try direct get
+                try {
+                    template = await client.templates.get(templateSlug);
+                }
+                catch {
+                    // Could not resolve — proceed without template data but record the slug
+                }
+            }
+        }
+        catch {
+            // Template lookup failed — proceed without template metadata; scaffold still happens
+        }
+    }
+    // --- Create project on the platform if client is available ---
+    let projectId = `proj_local_${Date.now().toString(36)}`;
+    let organizationId;
+    if (client) {
+        try {
+            const projectName = options.name || cwd.split('/').pop() || 'loxtep-project';
+            const createBody = {
+                name: projectName,
+                template_slug: templateSlug,
+                github_action: repoResult.action,
+            };
+            if (repoResult.action === 'create_new' && repoResult.repoName) {
+                createBody.github_repo_name = repoResult.repoName;
+            }
+            if (repoResult.action === 'import_existing' && repoResult.importUrl) {
+                createBody.github_import_url = repoResult.importUrl;
+            }
+            const project = await client.projects.create(createBody);
+            projectId = project.project_id;
+            organizationId = project.organization_id;
+        }
+        catch (err) {
+            // If project creation fails, proceed with local-only scaffold
+            const msg = err instanceof Error ? err.message : String(err);
+            stderr.push(`Warning: Could not create project on platform: ${msg}`);
+        }
+    }
+    // --- Scaffold standard directories (R1.1) ---
+    for (const dir of STANDARD_DIRS) {
+        await ensureDir(join(cwd, dir));
+    }
+    // --- Scaffold .loxtep/ directory + project.json ---
+    const loxtepDir = join(cwd, PROJECT_DIR_NAME);
+    await ensureDir(loxtepDir);
+    const config = {
+        project_id: projectId,
+        ...(organizationId ? { organization_id: organizationId } : {}),
+        ...(templateSlug ? { template_slug: templateSlug } : {}),
+        ...(options.instanceId ? { instance_id: options.instanceId } : {}),
+        ...(options.apiUrl ? { api_url: options.apiUrl } : {}),
+    };
+    const projectFilePath = join(loxtepDir, 'project.json');
+    await writeProjectConfig(projectFilePath, config);
+    // --- Template-specific scaffolding (R16.1, R16.2) ---
+    if (templateSlug) {
+        // AGENTS.md (R16.1)
+        const agentsMdContent = template
+            ? buildDefaultAgentsMd(templateSlug, template)
+            : buildDefaultAgentsMd(templateSlug, {
+                template_id: templateSlug,
+                name: templateSlug,
+                description: null,
+                category: '',
+                version: '1.0.0',
+                configuration: {},
+                validation_rules: {},
+                metadata: {},
+                is_public: true,
+                is_active: true,
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+            });
+        await writeFile(join(cwd, 'AGENTS.md'), agentsMdContent, 'utf-8');
+        // Default skill (.loxtep/skills/<slug>.yaml) (R16.2)
+        const skillsDir = join(loxtepDir, 'skills');
+        await ensureDir(skillsDir);
+        await writeFile(join(skillsDir, `${templateSlug}.yaml`), buildDefaultSkillYaml(templateSlug), 'utf-8');
+    }
+    stdout.push(`Initialized Loxtep project in ${cwd}`);
+    if (templateSlug) {
+        stdout.push(`  Template: ${templateSlug}`);
+    }
+    stdout.push('');
+    // --- Always print Getting Started + Quick Reference links (R11.7) ---
+    stdout.push(`Getting Started: ${GETTING_STARTED_URL}`);
+    stdout.push(`Quick Reference: ${QUICK_REFERENCE_URL}`);
+    stdout.push('');
+    // --- Auto-run generate when authed+attached (R16.3, R16.4, R16.5) ---
+    const isAttached = config.instance_id && config.api_url;
+    if (client && isAttached && options.runGenerate) {
+        // Project is authed + attached — run generate
+        const genResult = await options.runGenerate(cwd, client);
+        if (genResult.exitCode !== 0) {
+            // R16.4: if generate fails, the whole init fails
+            stderr.push(...genResult.stderr);
+            stderr.push('Init failed: generate step failed.');
+            return { exitCode: genResult.exitCode, stdout, stderr };
+        }
+        stdout.push(...genResult.stdout);
+    }
+    else if (!client) {
+        // R16.5: not authenticated — print guidance
+        stdout.push('Next steps:');
+        stdout.push('  1. loxtep login');
+        stdout.push('  2. loxtep attach --instance <instance-id>');
+        stdout.push('  3. loxtep generate');
+    }
+    else if (!isAttached) {
+        // Authed but not attached — print attach + generate guidance
+        stdout.push('Next steps:');
+        stdout.push('  1. loxtep attach --instance <instance-id>');
+        stdout.push('  2. loxtep generate');
+    }
+    return { exitCode: 0, stdout, stderr };
+}
+//# sourceMappingURL=init-cmd.js.map

package/dist/cli/commands/init-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-cmd.js","sourceRoot":"","sources":["../../../src/cli/commands/init-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/login.d.ts

@@ -8,10 +8,10 @@ export interface LoginOptions {
     mfa_code?: string;
     organization_id?: string;
     /**
-     * Browser OAuth login: opens browser to the Loxtep app login page with a localhost callback.
-     * This is the default when no email/password is provided.
+     * Force console/terminal login (email + password + optional TOTP prompts).
+     * Use for CI/headless environments or when browser is unavailable.
      */
-    browser?: boolean;
+    console?: boolean;
     /** For tests: inject fetch to mock API. */
     fetchFn?: typeof fetch;
     /** For tests: config file path (default: env/file). */
@@ -24,7 +24,7 @@ export interface LoginOptions {
     no_open?: boolean;
 }
 /**
- * Run login: by default opens a browser for OAuth login. Use --email/--password for headless/CI environments.
+ * Run login: by default opens a browser for OAuth login. Use --console or --email/--password for headless/CI environments.
  */
 export declare function runLogin(options?: LoginOptions): Promise<void>;
 //# sourceMappingURL=login.d.ts.map