@p11-core/cli 0.0.11 → 0.0.12

package/docs/components.md

@@ -76,7 +76,7 @@ Supported languages include TypeScript, JavaScript, Python, Rust, HTML/XML, CSS,
 
 ## Validation
 
-`p11 share` validates the document before build and upload.
+Before sharing, `p11 share` validates the document.
 
 Do not import or render app/control components such as:
 

package/docs/index.md

@@ -14,7 +14,7 @@ p11 comments <readUrl|editUrl|readId|editId>
 p11 delete <editUrl|editId>
 ```
 
-Add `--json` when scripting or when exact structured fields are needed.
+For `share`, `history`, `comments`, and `delete`, add `--json` when scripting or when exact structured fields are needed.
 
 ## Docs Topics
 

package/docs/sharing.md

@@ -35,6 +35,6 @@ p11 delete <editUrl|editId>
 Add `--json` when scripting or when exact structured fields are needed.
 
 `P11_API_URL` overrides the default API URL. `--api-url <url>` can override it per command.
-Temporary share builds are created under the OS temp directory by default. Use `P11_BUILD_DIR` or `--build-dir <dir>` only when you need to inspect or redirect the transient build workspace.
+Use `P11_BUILD_DIR` or `--build-dir <dir>` only when you need a custom working directory while sharing.
 
 Edit URLs are bearer credentials for updating or deleting a document. Keep them private.

package/examples/all-components.tsx

@@ -26,7 +26,7 @@ import {
 } from "@p11-core/components";
 
 const figureSrc =
-  "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 720 240'%3E%3Crect width='720' height='240' fill='%23f8fafc'/%3E%3Cpath d='M80 172h560' stroke='%23d4d4d8' stroke-width='2'/%3E%3Ccircle cx='160' cy='132' r='42' fill='%2318181b'/%3E%3Crect x='260' y='92' width='120' height='80' rx='8' fill='%2352525b'/%3E%3Cpath d='M460 172 540 72l80 100z' fill='%2371717a'/%3E%3Ctext x='80' y='52' font-family='Inter, Arial' font-size='28' font-weight='700' fill='%2318181b'%3Ep11 document figure%3C/text%3E%3C/svg%3E";
+  "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 720 240'%3E%3Crect width='720' height='240' fill='%23f8fafc'/%3E%3Cpath d='M80 172h560' stroke='%23d4d4d8' stroke-width='2'/%3E%3Ccircle cx='160' cy='132' r='42' fill='%2318181b'/%3E%3Crect x='260' y='92' width='120' height='80' rx='8' fill='%2352525b'/%3E%3Cpath d='M460 172 540 72l80 100z' fill='%2371717a'/%3E%3Ctext x='80' y='52' font-family='Inter, Arial' font-size='28' font-weight='700' fill='%2318181b'%3ESample document figure%3C/text%3E%3C/svg%3E";
 
 export default function All() {
   return (
@@ -35,26 +35,25 @@ export default function All() {
         <Section>
           <Heading level={1}>All Components Showcase</Heading>
           <Text>
-            This example replaces the original decision brief with a compact
-            tour of every document-safe component exported by{" "}
-            <code>@p11-core/components</code>. It also includes safe inline markup
-            such as <strong>strong text</strong>, <em>emphasis</em>,{" "}
+            This example is a compact tour of every available document
+            component. It also includes common inline markup such as{" "}
+            <strong>strong text</strong>, <em>emphasis</em>,{" "}
             <code>inline code</code>,{" "}
             <Strikethrough>obsolete wording</Strikethrough>, and a{" "}
-            <a href="https://example.com">print-safe link</a>.
+            <a href="https://example.com">sample link</a>.
           </Text>
           <Quote>
-            The page is intentionally broad: authors can use it to inspect
-            screen layout, print pagination, source-line anchors, tables,
-            figures, and syntax highlighting in one shared document.
+            The page is intentionally broad: authors can inspect text hierarchy,
+            lists, tables, figures, page breaks, and syntax highlighting in one
+            sample document.
           </Quote>
         </Section>
 
         <Section>
           <Heading>1. Text Hierarchy</Heading>
           <Text>
-            The heading component supports levels one through six while keeping
-            the document printable and commentable.
+            The heading component supports levels one through six for clear
+            document structure.
           </Text>
           <Heading level={2}>Level Two Heading</Heading>
           <Text>
@@ -73,21 +72,21 @@ export default function All() {
         <Section>
           <Heading>2. Lists</Heading>
           <Text>
-            Unordered lists work for parallel facts and short capabilities.
+            Unordered lists work for parallel facts and concise observations.
           </Text>
           <List>
-            <ListItem>Share static React-authored documents.</ListItem>
-            <ListItem>Allow anonymous comments on text selections.</ListItem>
+            <ListItem>Summarize goals and outcomes.</ListItem>
+            <ListItem>Group related facts into scannable entries.</ListItem>
             <ListItem>
-              Export comments with source file and line anchors.
+              Keep supporting details close to the relevant topic.
             </ListItem>
           </List>
           <Text>Ordered lists work for procedural steps.</Text>
           <List ordered>
-            <ListItem>Author a document file.</ListItem>
-            <ListItem>Share it with the CLI.</ListItem>
+            <ListItem>Draft the initial material.</ListItem>
+            <ListItem>Review the structure and supporting evidence.</ListItem>
             <ListItem>
-              Review the screen view and browser print output.
+              Prepare the final version for its audience.
             </ListItem>
           </List>
         </Section>
@@ -102,12 +101,12 @@ export default function All() {
           <DefinitionList>
             <DefinitionTerm>Page</DefinitionTerm>
             <DefinitionDescription>
-              A printable document surface with fixed letter-sized dimensions.
+              A bounded document surface used to organize related sections.
             </DefinitionDescription>
-            <DefinitionTerm>Comment anchor</DefinitionTerm>
+            <DefinitionTerm>Margin note</DefinitionTerm>
             <DefinitionDescription>
-              Source metadata attached to document text so reviewer feedback can
-              point back to authored content.
+              A short observation that adds context without interrupting the
+              main flow.
             </DefinitionDescription>
           </DefinitionList>
         </Section>
@@ -118,27 +117,27 @@ export default function All() {
             <TableHeader>
               <TableRow>
                 <TableHead>Component</TableHead>
-                <TableHead>Rendered Tag</TableHead>
+                <TableHead>Example Use</TableHead>
                 <TableHead>Purpose</TableHead>
               </TableRow>
             </TableHeader>
             <TableBody>
               <TableRow>
                 <TableCell>TableHeader</TableCell>
-                <TableCell>thead</TableCell>
+                <TableCell>Column labels</TableCell>
                 <TableCell>
-                  Groups the header rows for print-safe tables.
+                  Groups the header rows for structured data.
                 </TableCell>
               </TableRow>
               <TableRow>
                 <TableCell>TableBody</TableCell>
-                <TableCell>tbody</TableCell>
+                <TableCell>Table content</TableCell>
                 <TableCell>Groups the body rows and cells.</TableCell>
               </TableRow>
               <TableRow>
                 <TableCell>TableHead and TableCell</TableCell>
-                <TableCell>th and td</TableCell>
-                <TableCell>Provide commentable table content.</TableCell>
+                <TableCell>Labels and values</TableCell>
+                <TableCell>Present comparable table content.</TableCell>
               </TableRow>
             </TableBody>
           </Table>
@@ -149,11 +148,11 @@ export default function All() {
           <Figure>
             <img
               src={figureSrc}
-              alt="Abstract p11 document figure with simple geometric marks"
+              alt="Abstract sample document figure with simple geometric marks"
             />
             <Caption>
-              Figure 1. Figure and Caption components keep visual evidence with
-              its explanatory text.
+              Figure 1. Figure and Caption components keep visual material with
+              its explanation.
             </Caption>
           </Figure>
         </Section>
@@ -166,18 +165,18 @@ export default function All() {
           <Heading>6. TypeScript</Heading>
           <CodeBlock language="typescript">
             {code`
-              type ShareOptions = {
-                input: string;
-                comments?: boolean;
+              type BriefOptions = {
+                title: string;
+                includeSummary?: boolean;
               };
 
-              export async function share(options: ShareOptions) {
-                const response = await fetch("/api/pages", {
+              export async function createBrief(options: BriefOptions) {
+                const response = await fetch("/api/briefs", {
                   method: "POST",
                   body: JSON.stringify(options)
                 });
 
-                return response.json() as Promise<{ docId: string; readUrl: string; editUrl: string; version: number }>;
+                return response.json() as Promise<{ id: string; title: string; updatedAt: string }>;
               }
             `}
           </CodeBlock>
@@ -187,11 +186,11 @@ export default function All() {
           <Heading>7. JavaScript</Heading>
           <CodeBlock language="javascript">
             {code`
-              const pages = new Map();
+              const notes = new Map();
 
-              export function rememberPage(page) {
-                pages.set(page.id, {
-                  ...page,
+              export function rememberNote(note) {
+                notes.set(note.id, {
+                  ...note,
                   updatedAt: new Date().toISOString()
                 });
               }
@@ -206,12 +205,12 @@ export default function All() {
               from dataclasses import dataclass
 
               @dataclass
-              class Comment:
-                  author: str
-                  body: str
+              class Task:
+                  owner: str
+                  title: str
 
-              def preview(comment: Comment) -> str:
-                  return f"{comment.author}: {comment.body[:48]}"
+              def preview(task: Task) -> str:
+                  return f"{task.owner}: {task.title[:48]}"
             `}
           </CodeBlock>
         </Section>
@@ -221,13 +220,13 @@ export default function All() {
           <CodeBlock language="rust">
             {code`
               #[derive(Debug)]
-              struct Page<'a> {
+              struct Milestone<'a> {
                   id: &'a str,
-                  comments_enabled: bool,
+                  complete: bool,
               }
 
-              fn describe(page: &Page) -> String {
-                  format!("{} comments={}", page.id, page.comments_enabled)
+              fn describe(milestone: &Milestone) -> String {
+                  format!("{} complete={}", milestone.id, milestone.complete)
               }
             `}
           </CodeBlock>
@@ -237,9 +236,9 @@ export default function All() {
           <Heading>10. HTML And XML</Heading>
           <CodeBlock language="html">
             {code`
-              <article class="p11-page">
+              <article class="sample-page">
                 <h1>All Components Showcase</h1>
-                <p data-p11-block>Reviewers can comment on document text.</p>
+                <p>Each section demonstrates a different document pattern.</p>
               </article>
             `}
           </CodeBlock>
@@ -253,13 +252,13 @@ export default function All() {
           <Heading>11. CSS</Heading>
           <CodeBlock language="css">
             {code`
-              .p11-page {
+              .sample-page {
                 color: #27272a;
-                font-family: var(--p11-font-body);
+                font-family: ui-serif, Georgia, serif;
                 line-height: 1.62;
               }
 
-              .p11-code-block code.hljs {
+              .sample-code-block code {
                 background: transparent;
               }
             `}
@@ -271,9 +270,8 @@ export default function All() {
           <CodeBlock language="json">
             {code`
               {
-                "docId": "all",
+                "title": "All Components Showcase",
                 "version": 2,
-                "comments": true,
                 "languages": ["typescript", "javascript", "python", "rust", "html", "css", "json", "yaml", "bash"]
               }
             `}
@@ -285,10 +283,8 @@ export default function All() {
           <CodeBlock language="yaml">
             {code`
               document:
-                id: all
+                title: All Components Showcase
                 version: 2
-                comments: true
-                retentionDays: 7
               languages:
                 - typescript
                 - javascript
@@ -307,8 +303,8 @@ export default function All() {
           <Heading>14. Bash</Heading>
           <CodeBlock language="bash">
             {code`
-              p11 share ./all.tsx
-              p11 comments <readUrl> --version 1
+              mkdir -p notes
+              printf "Summary ready\n" > notes/summary.txt
             `}
           </CodeBlock>
         </Section>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@p11-core/cli",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "license": "UNLICENSED",
   "type": "module",
   "bin": {