emdash-emit 0.0.0-stage → 0.1.2

package/dist/cli/commands/status.js

@@ -0,0 +1,100 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+import { getWorkspaceStatus } from '../../sync/status.js';
+export function registerStatusInitCommands(program, resolveContext) {
+    // emit status
+    program
+        .command('status')
+        .description('Show sync status of articles in local workspace')
+        .option('-c, --collection <collection>', 'Collection to check (default: posts)')
+        .option('-p, --profile <name>', 'Explicitly use a specific connection profile')
+        .action((options) => {
+        const ctx = resolveContext(options.profile);
+        const collection = options.collection || ctx.config.defaultCollection;
+        const status = getWorkspaceStatus(ctx.root, ctx.cache, collection);
+        console.log(`\n--- Workspace Status (${collection} | origin: ${ctx.origin}) ---`);
+        for (const item of status.items) {
+            let icon = '🟢';
+            let label = 'synced  ';
+            if (item.syncStatus === 'modified') {
+                icon = '🟡';
+                label = 'modified';
+            }
+            else if (item.syncStatus === 'untracked') {
+                icon = '⚪';
+                label = 'untracked';
+            }
+            const titleDisplay = item.title ? ` (${item.title})` : '';
+            const paddedStatus = (item.status || '').padEnd(9, ' ');
+            console.log(`  ${icon} [${label}] ${paddedStatus} ${item.filePath}${titleDisplay}`);
+        }
+        console.log(`\nSummary: ${status.summary.total} total (${status.summary.synced} synced, ${status.summary.modified} modified, ${status.summary.untracked} untracked)\n`);
+    });
+    // emit guide
+    program
+        .command('guide')
+        .description('Display the Golden Path workflow and tips for humans & AI')
+        .action(() => {
+        console.log(`
+========================================================================
+  Emit - The Golden Path Workflow for Humans & AI
+========================================================================
+
+■ 4-Step Article Authoring Flow
+  1. Scaffold:      emit new <slug> --title "Article Title"
+                    --> Automatically generates posts/draft/<yyyyMMdd>_<ulid>-<title>.md
+  2. Write & Edit:  Freely edit posts/draft/*.md with editor or AI.
+                    --> No need to write a redundant # Title header in the body.
+                    --> Reference frontmatter taxonomies for categories and tags.
+  3. Push Draft:    emit push <file>
+                    --> Safely syncs to EmDash remote as staged draft.
+  4. Publish Live:  Update frontmatter status to "published", then run:
+                    emit push <file> --allow-publish
+
+■ Handy Commands
+  - emit status     ... View local editing status and diff against remote
+  - emit pull [id]  ... Sync remote content into local workspace window
+  - emit mcp        ... Launch stdio MCP server for AI agents (Antigravity, Claude Code)
+
+■ Collaboration Rules with AI (AGENTS.md)
+  - Strict prohibition against creating throwaway temporary files (e.g. temp.md).
+  - Never manually rename (mv) cached files; update the frontmatter slug/status instead.
+========================================================================
+`);
+    });
+    // emit init
+    program
+        .command('init')
+        .description('Initialize current directory as an Emit local workspace')
+        .option('--origin <url>', 'EmDash instance origin URL')
+        .action(async (options) => {
+        const root = process.cwd();
+        const { initWorkspace } = await import('../../utils/config.js');
+        const { getWorkspacePaths } = await import('../../utils/workspace.js');
+        initWorkspace(root, options.origin ? { origin: options.origin } : undefined);
+        const paths = getWorkspacePaths(root);
+        console.log(`✅ Initialized Emit workspace at: ${root}`);
+        console.log(`   Config: ${paths.configPath}`);
+        console.log(`   Database: ${paths.dbPath}`);
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

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

package/dist/cli/context.d.ts

@@ -0,0 +1,15 @@
+import { CacheDatabase } from '../db/cache.js';
+import { type ResolvedAuth } from '../client/auth.js';
+import { type WorkspacePaths } from '../utils/workspace.js';
+import { type EmitConfig } from '../utils/config.js';
+export interface CliContext {
+    root: string;
+    paths: WorkspacePaths;
+    cache: CacheDatabase;
+    config: EmitConfig;
+    auth: ResolvedAuth;
+    origin: string;
+}
+export type CliContextResolver = (profileName?: string) => CliContext;
+export declare function createCliContextResolver(): CliContextResolver;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;AAEtE,wBAAgB,wBAAwB,IAAI,kBAAkB,CAiD7D"}

package/dist/cli/context.js

@@ -0,0 +1,75 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+import { CacheDatabase } from '../db/cache.js';
+import { resolveAuth } from '../client/auth.js';
+import { getWorkspacePaths, requireWorkspaceRoot, } from '../utils/workspace.js';
+import { loadConfig } from '../utils/config.js';
+import { loadProfilesFile, AmbiguousProfileError } from '../utils/profile.js';
+export function createCliContextResolver() {
+    return (profileName) => {
+        let auth;
+        try {
+            const resolved = resolveAuth({ profile: profileName });
+            if (!resolved) {
+                console.error('❌ Error: No authentication found.');
+                console.error('   Please run "emit profile add <name> --origin <url> --token <token>"');
+                console.error('   or set EMDASH_TOKEN environment variable.');
+                process.exit(1);
+            }
+            auth = resolved;
+        }
+        catch (err) {
+            if (err instanceof AmbiguousProfileError) {
+                console.error(`\n❌ Error: ${err.message}`);
+                console.error('   Please specify a profile with --profile <name>.');
+                console.error(`   Available profiles: ${err.availableProfiles.join(', ')}\n`);
+                process.exit(1);
+            }
+            throw err;
+        }
+        const profilesData = loadProfilesFile();
+        const activeProf = profileName ? profilesData.profiles[profileName] : undefined;
+        const origin = activeProf?.origin || auth.origin || 'https://example.com';
+        let workspaceRoot;
+        try {
+            workspaceRoot =
+                activeProf?.workspace || process.env.EMDASH_WORKSPACE || requireWorkspaceRoot();
+        }
+        catch {
+            console.error('❌ Error: Current directory is not inside an Emit workspace.');
+            console.error('   Run "emit init" to initialize this directory, or "cd" into a workspace.');
+            process.exit(1);
+        }
+        const paths = getWorkspacePaths(workspaceRoot);
+        const cache = new CacheDatabase(paths.dbPath);
+        const config = loadConfig(paths.configPath);
+        return {
+            root: workspaceRoot,
+            paths,
+            cache,
+            config,
+            auth,
+            origin,
+        };
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAqB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAmB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAa9E,MAAM,UAAU,wBAAwB;IACtC,OAAO,CAAC,WAAoB,EAAc,EAAE;QAC1C,IAAI,IAAkB,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACnD,OAAO,CAAC,KAAK,CAAC,wEAAwE,CAAC,CAAC;gBACxF,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;gBACzC,OAAO,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3C,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;gBACpE,OAAO,CAAC,KAAK,CAAC,0BAA0B,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,MAAM,GAAG,UAAU,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,IAAI,qBAAqB,CAAC;QAE1E,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,aAAa;gBACX,UAAU,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,oBAAoB,EAAE,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;YAC7E,OAAO,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;YAC5F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE5C,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,KAAK;YACL,KAAK;YACL,MAAM;YACN,IAAI;YACJ,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/client/api.d.ts

@@ -0,0 +1,19 @@
+export interface UnwrappedEnvelope<T = Record<string, unknown>> {
+    data: T;
+    rev: string;
+}
+/**
+ * Validates and safely extracts the primary data object from an API response envelope.
+ * Handles { success: true, data: T } or plain T responses.
+ * Note: If raw itself has an `id` field (already an item), do not unwrap `raw.data` (which is content data).
+ */
+export declare function unwrapEnvelope<T = Record<string, unknown>>(raw: unknown): T;
+/**
+ * Validates and safely extracts the item from a response or nested envelope ({ item: T }, { data: { item: T } } or T).
+ */
+export declare function unwrapItem<T = Record<string, unknown>>(raw: unknown): T;
+/**
+ * Extracts revision string from an API response, prioritizing data._rev over item._rev, rev, version.
+ */
+export declare function extractRev(raw: unknown, fallback?: string): string;
+//# sourceMappingURL=api.d.ts.map

package/dist/client/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/client/api.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC;IACR,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAiB3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CA6BvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,SAAM,GAAG,MAAM,CAmB/D"}

package/dist/client/api.js

@@ -0,0 +1,96 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+/**
+ * Safe unwrap utilities for EmDash API response envelopes and revision extraction.
+ */
+import { ContentEnvelopeSchema, ContentItemSchema, } from './schemas.js';
+/**
+ * Validates and safely extracts the primary data object from an API response envelope.
+ * Handles { success: true, data: T } or plain T responses.
+ * Note: If raw itself has an `id` field (already an item), do not unwrap `raw.data` (which is content data).
+ */
+export function unwrapEnvelope(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return {};
+    }
+    // Parse against envelope schema if possible
+    const parsedEnvelope = ContentEnvelopeSchema.safeParse(raw);
+    const obj = (parsedEnvelope.success ? parsedEnvelope.data : raw);
+    if ('data' in obj && obj.data && typeof obj.data === 'object' && !Array.isArray(obj.data)) {
+        // If obj already has top-level `id` or `slug`, obj is already the content item, not an API envelope!
+        if ('id' in obj || 'slug' in obj) {
+            return obj;
+        }
+        return obj.data;
+    }
+    return obj;
+}
+/**
+ * Validates and safely extracts the item from a response or nested envelope ({ item: T }, { data: { item: T } } or T).
+ */
+export function unwrapItem(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return {};
+    }
+    const parsedEnvelope = ContentEnvelopeSchema.safeParse(raw);
+    const root = (parsedEnvelope.success ? parsedEnvelope.data : raw);
+    // If root has data.item
+    if (root.data && typeof root.data === 'object' && !Array.isArray(root.data)) {
+        const dataObj = root.data;
+        if (dataObj.item && typeof dataObj.item === 'object') {
+            const parsedItem = ContentItemSchema.safeParse(dataObj.item);
+            return (parsedItem.success ? parsedItem.data : dataObj.item);
+        }
+        if (dataObj.id) {
+            const parsedItem = ContentItemSchema.safeParse(dataObj);
+            return (parsedItem.success ? parsedItem.data : dataObj);
+        }
+    }
+    // If root has item
+    if (root.item && typeof root.item === 'object') {
+        const parsedItem = ContentItemSchema.safeParse(root.item);
+        return (parsedItem.success ? parsedItem.data : root.item);
+    }
+    const parsedItem = ContentItemSchema.safeParse(root);
+    return (parsedItem.success ? parsedItem.data : root);
+}
+/**
+ * Extracts revision string from an API response, prioritizing data._rev over item._rev, rev, version.
+ */
+export function extractRev(raw, fallback = '1') {
+    if (!raw || typeof raw !== 'object') {
+        return fallback;
+    }
+    const root = raw;
+    let envelopeRev = '';
+    if (root.data && typeof root.data === 'object' && !Array.isArray(root.data)) {
+        const dataObj = root.data;
+        if (dataObj._rev)
+            envelopeRev = String(dataObj._rev);
+        else if (dataObj.rev)
+            envelopeRev = String(dataObj.rev);
+    }
+    const item = unwrapItem(raw);
+    const rev = item._rev || envelopeRev || root._rev || item.rev || root.rev || item.version || root.version;
+    return rev ? String(rev) : fallback;
+}
+//# sourceMappingURL=api.js.map

package/dist/client/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/client/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;GAEG;AAEH,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AAOtB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAA8B,GAAY;IACtE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAO,CAAC;IACjB,CAAC;IAED,4CAA4C;IAC5C,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAA4B,CAAC;IAE5F,IAAI,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1F,qGAAqG;QACrG,IAAI,IAAI,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;YACjC,OAAO,GAAQ,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC,IAAS,CAAC;IACvB,CAAC;IACD,OAAO,GAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAA8B,GAAY;IAClE,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,EAAO,CAAC;IACjB,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAA4B,CAAC;IAE7F,wBAAwB;IACxB,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,IAA+B,CAAC;QACrD,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAM,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAM,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAM,CAAC;IACjE,CAAC;IAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAM,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,QAAQ,GAAG,GAAG;IACrD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,GAA8B,CAAC;IAC5C,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,IAA+B,CAAC;QACrD,IAAI,OAAO,CAAC,IAAI;YAAE,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aAChD,IAAI,OAAO,CAAC,GAAG;YAAE,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAA0B,GAAG,CAAC,CAAC;IACtD,MAAM,GAAG,GACP,IAAI,CAAC,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;IAEhG,OAAO,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtC,CAAC"}

package/dist/client/auth.d.ts

@@ -0,0 +1,48 @@
+export interface EmDashAuthData {
+    origin?: string;
+    access_token: string;
+    refresh_token?: string;
+    tokenScopes?: string[];
+    expires_at?: number;
+}
+export interface ResolvedAuth {
+    source: 'env' | 'profile' | 'emdash-cli' | 'emit-config';
+    token: string;
+    origin?: string;
+    refreshToken?: string;
+    scopes?: string[];
+    profileName?: string;
+    workspace?: string;
+}
+export interface AuthOptions {
+    profile?: string;
+    cwd?: string;
+    customProfilesPath?: string;
+    customConfigPath?: string;
+    emdashAuthPath?: string;
+}
+/**
+ * Resolves default path for EmDash CLI auth storage (~/.config/emdash/auth.json).
+ */
+export declare function getDefaultEmDashAuthPath(): string;
+/**
+ * Resolves default path for Emit custom credentials (~/.config/emit/credentials.json).
+ */
+export declare function getDefaultEmitCredentialsPath(): string;
+/**
+ * Resolves authentication credentials with prioritized fallback:
+ * 1. Environment variables (EMDASH_TOKEN or EMDASH_API_TOKEN) -> Top priority for CI / one-off overrides
+ * 2. Profile from ~/.config/emit/profiles.yaml (explicit profile, or workspace directory match, or single site)
+ * 3. EmDash CLI credentials (~/.config/emdash/auth.json)
+ * 4. Emit custom credentials (~/.config/emit/credentials.json)
+ */
+export declare function resolveAuth(options?: AuthOptions): ResolvedAuth | null;
+/**
+ * Validates whether the token has the required scope.
+ */
+export declare function hasRequiredScope(scopes: string[] | undefined, requiredScope: string): boolean;
+/**
+ * Refreshes an expired OAuth access token using its refresh_token.
+ */
+export declare function refreshAccessToken(auth: ResolvedAuth, authFilePath?: string, fetchFn?: typeof fetch): Promise<ResolvedAuth>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,IAAI,CAqEtE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAM7F;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,YAAY,EAClB,YAAY,GAAE,MAAmC,EACjD,OAAO,GAAE,OAAO,KAAa,GAC5B,OAAO,CAAC,YAAY,CAAC,CAkDvB"}

package/dist/client/auth.js

@@ -0,0 +1,165 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { resolveTargetProfile } from '../utils/profile.js';
+/**
+ * Resolves default path for EmDash CLI auth storage (~/.config/emdash/auth.json).
+ */
+export function getDefaultEmDashAuthPath() {
+    return path.join(os.homedir(), '.config', 'emdash', 'auth.json');
+}
+/**
+ * Resolves default path for Emit custom credentials (~/.config/emit/credentials.json).
+ */
+export function getDefaultEmitCredentialsPath() {
+    return path.join(os.homedir(), '.config', 'emit', 'credentials.json');
+}
+/**
+ * Resolves authentication credentials with prioritized fallback:
+ * 1. Environment variables (EMDASH_TOKEN or EMDASH_API_TOKEN) -> Top priority for CI / one-off overrides
+ * 2. Profile from ~/.config/emit/profiles.yaml (explicit profile, or workspace directory match, or single site)
+ * 3. EmDash CLI credentials (~/.config/emdash/auth.json)
+ * 4. Emit custom credentials (~/.config/emit/credentials.json)
+ */
+export function resolveAuth(options) {
+    // 1. Environment variables (highest priority for overrides/CI)
+    const envToken = process.env.EMDASH_TOKEN || process.env.EMDASH_API_TOKEN;
+    if (envToken) {
+        return {
+            source: 'env',
+            token: envToken,
+            origin: process.env.EMDASH_ORIGIN,
+        };
+    }
+    // 2. Profile from ~/.config/emit/profiles.yaml (may throw AmbiguousProfileError if multiple sites)
+    const profileRes = resolveTargetProfile({
+        profile: options?.profile,
+        cwd: options?.cwd,
+        customPath: options?.customProfilesPath,
+    });
+    if (profileRes && profileRes.config.token) {
+        return {
+            source: 'profile',
+            token: profileRes.config.token,
+            origin: profileRes.config.origin,
+            profileName: profileRes.name,
+            workspace: profileRes.config.workspace,
+        };
+    }
+    // 3. EmDash CLI auth.json
+    const emdashPath = options?.emdashAuthPath || getDefaultEmDashAuthPath();
+    if (fs.existsSync(emdashPath)) {
+        try {
+            const raw = fs.readFileSync(emdashPath, 'utf8');
+            const data = JSON.parse(raw);
+            if (data.access_token) {
+                return {
+                    source: 'emdash-cli',
+                    token: data.access_token,
+                    origin: data.origin,
+                    refreshToken: data.refresh_token,
+                    scopes: data.tokenScopes,
+                };
+            }
+        }
+        catch {
+            // Ignore parse/read failure, try next tier
+        }
+    }
+    // 4. Emit credentials.json
+    const emitPath = options?.customConfigPath || getDefaultEmitCredentialsPath();
+    if (fs.existsSync(emitPath)) {
+        try {
+            const raw = fs.readFileSync(emitPath, 'utf8');
+            const data = JSON.parse(raw);
+            if (data.access_token) {
+                return {
+                    source: 'emit-config',
+                    token: data.access_token,
+                    origin: data.origin,
+                    refreshToken: data.refresh_token,
+                    scopes: data.tokenScopes,
+                };
+            }
+        }
+        catch {
+            // Ignore parse/read failure
+        }
+    }
+    return null;
+}
+/**
+ * Validates whether the token has the required scope.
+ */
+export function hasRequiredScope(scopes, requiredScope) {
+    if (!scopes || scopes.length === 0) {
+        // If scopes are not declared, assume allowed until API returns 403
+        return true;
+    }
+    return scopes.includes(requiredScope) || scopes.includes('*') || scopes.includes('admin');
+}
+/**
+ * Refreshes an expired OAuth access token using its refresh_token.
+ */
+export async function refreshAccessToken(auth, authFilePath = getDefaultEmDashAuthPath(), fetchFn = fetch) {
+    if (!auth.refreshToken || !auth.origin) {
+        throw new Error('Cannot refresh token: missing refresh_token or origin. Please run "emdash login" again.');
+    }
+    const tokenUrl = new URL('/_emdash/api/auth/token', auth.origin).toString();
+    const res = await fetchFn(tokenUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            grant_type: 'refresh_token',
+            refresh_token: auth.refreshToken,
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`Token refresh failed with status ${res.status}. Please run "emdash login" to re-authenticate.`);
+    }
+    const json = (await res.json());
+    const updatedAuth = {
+        ...auth,
+        token: json.access_token,
+        refreshToken: json.refresh_token || auth.refreshToken,
+        scopes: json.tokenScopes || auth.scopes,
+    };
+    // Persist updated token to auth file if it originated from emdash-cli
+    if (auth.source === 'emdash-cli' && fs.existsSync(authFilePath)) {
+        try {
+            const current = JSON.parse(fs.readFileSync(authFilePath, 'utf8'));
+            current.access_token = updatedAuth.token;
+            if (json.refresh_token)
+                current.refresh_token = json.refresh_token;
+            if (json.tokenScopes)
+                current.tokenScopes = json.tokenScopes;
+            fs.writeFileSync(authFilePath, JSON.stringify(current, null, 2), 'utf8');
+        }
+        catch {
+            // Failed to persist, continue with in-memory token
+        }
+    }
+    return updatedAuth;
+}
+//# sourceMappingURL=auth.js.map

package/dist/client/auth.js.map

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

package/dist/client/error.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Structured API Error class representing failed EmDash API operations.
+ * Carries HTTP status, internal error code, and actionable suggestions for user or AI recovery (G8).
+ */
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly status?: number;
+    readonly suggestion?: string;
+    readonly endpoint?: string;
+    constructor(options: {
+        message: string;
+        code: string;
+        status?: number;
+        suggestion?: string;
+        endpoint?: string;
+    });
+    /**
+     * Formats the error into an actionable message suitable for console or MCP tool output.
+     */
+    toActionableString(): string;
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/client/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/client/error.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElC,YAAY,OAAO,EAAE;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,EAYA;IAED;;OAEG;IACI,kBAAkB,IAAI,MAAM,CAMlC;CACF"}

package/dist/client/error.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright (C) 2026 SPORT-SERVICE RS★R
+ *
+ * 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.
+ */
+/**
+ * Structured API Error class representing failed EmDash API operations.
+ * Carries HTTP status, internal error code, and actionable suggestions for user or AI recovery (G8).
+ */
+export class ApiError extends Error {
+    code;
+    status;
+    suggestion;
+    endpoint;
+    constructor(options) {
+        super(options.message);
+        this.name = 'ApiError';
+        this.code = options.code;
+        this.status = options.status;
+        this.suggestion = options.suggestion;
+        this.endpoint = options.endpoint;
+        // Maintains proper stack trace in V8 / Node.js
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ApiError);
+        }
+    }
+    /**
+     * Formats the error into an actionable message suitable for console or MCP tool output.
+     */
+    toActionableString() {
+        const lines = [`❌ [${this.code}] ${this.message}`];
+        if (this.status)
+            lines.push(`   Status: HTTP ${this.status}`);
+        if (this.endpoint)
+            lines.push(`   Endpoint: ${this.endpoint}`);
+        if (this.suggestion)
+            lines.push(`   💡 Suggestion: ${this.suggestion}`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=error.js.map